Avançar para o conteúdo

Ideogram V3 Character Remix

Integrar

ID do modelo ideogram/character/remix
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/character/remix?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Este pedido: 0,15 $ 150 créditos da API · ≈ 15,98 ₽ Executar nesta página

Obter chave de API
Ideogram Edição de imagem Entradas de referência #character-consistency

Remix Ideogram V3 de uma imagem de entrada para novos estilos ou cenas, mantendo uma personagem de referência

Ideogram · Imagem

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório

Prompt utilizado para orientar o remix da imagem.

•obrigatório image_url
Largue um ficheiro ou

URL da imagem a ser remisturada.

•obrigatório
Largue um ficheiro ou

Imagens de referência de personagens nos formatos JPEG, PNG ou WebP, com um limite combinado de 10 MB para todas as referências de personagens. O suporte está atualmente limitado a 1 imagem; as imagens adicionais são ignoradas.

rendering_speed predefinição BALANCED

Definição de velocidade da renderização.

image_size predefinição square_hd

Resolução a utilizar para a imagem de saída.

num_images predefinição 1

Número de imagens a produzir.

Avançado negative_prompt · images · reference_mask_urls · style · strength · seed · expand_prompt · style_codes · color_palette
predefinição

Especifique conteúdo de imagem indesejado, ficando as descrições do prompt principal com prioridade sobre estas descrições do prompt negativo.

image_urls
Largue um ficheiro ou

Imagens de referência de estilo nos formatos JPEG, PNG ou WebP. O tamanho combinado não pode exceder 10 MB.

Largue um ficheiro ou

Máscaras de referência de personagens nos formatos JPEG, PNG ou WebP; o tamanho total de todas as referências de personagens não pode exceder 10 MB. Atualmente é utilizada apenas 1 máscara; as máscaras adicionais são ignoradas.

style predefinição AUTO

Tipo de estilo utilizado para a geração; mutuamente exclusivo com style_codes.

predefinição 0.8

Influência da imagem de origem no remix.

Valor da seed para a geração de números aleatórios.

Códigos de estilo de imagem, fornecidos como strings hexadecimais de 8 caracteres cada; omita style_reference_images e style ao utilizar esta lista.

Paleta de cores utilizada durante a geração. Especifique uma predefinição através de name ou cores hexadecimais explícitas através de members, opcionalmente incluindo pesos.

POST /run/ideogram/character/remix?wait=20 cotação → 0,15 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/character/remix?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre Ideogram V3 Character Remix

Faz o remix de `image_url` com um `prompt`, mantendo a personagem de `reference_image_urls` (é utilizada 1 imagem). `strength` (0.01-1, predefinição 0.8) controla a influência da imagem de entrada. Suporta predefinições de `image_size`, referências de estilo, `style` com AUTO, REALISTIC ou FICTION e até 8 imagens.

Parâmetros

Envie o nome canónico ou o nome nativo, não ambos. Nomes canónicos

NomeTipo PredefiniçãoPermitido Descrição
image_urlsopcional images
Tipourl[] · image
Imagens de referência de estilo nos formatos JPEG, PNG ou WebP. O tamanho combinado não pode exceder 10 MB.
rendering_speedopcional
Tipoenum
PredefiniçãoBALANCED
TURBOBALANCEDQUALITY
Definição de velocidade da renderização.
color_paletteopcional
Tipoobject
Paleta de cores utilizada durante a geração. Especifique uma predefinição através de name ou cores hexadecimais explícitas através de members, opcionalmente incluindo pesos.
color_palette.membersopcional
Tipoobject[]
Lista de membros da paleta que define as respetivas cores.
color_palette.members[].rgbobrigatório
Tipoobject
Cor do membro da paleta expressa como RGB.
color_palette.members[].color_weightopcional
Tiponumber | null
Predefinição0.5
0,05 – 1
Peso atribuído a esta cor na paleta.
color_palette.nameopcional
Tipoenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Seleção da predefinição da paleta de cores.
style_codesopcional
Tipostring[]
Códigos de estilo de imagem, fornecidos como strings hexadecimais de 8 caracteres cada; omita style_reference_images e style ao utilizar esta lista.
styleopcional
Tipoenum
PredefiniçãoAUTO
AUTOREALISTICFICTION
Tipo de estilo utilizado para a geração; mutuamente exclusivo com style_codes.
expand_promptopcional
Tipoboolean
Predefiniçãotrue
Opção de utilização do MagicPrompt para a geração do pedido.
num_imagesopcional num_outputs
Tipointeger
Predefinição1
1 – 8
Número de imagens a produzir.
seedopcional
Tipointeger | null
Valor da seed para a geração de números aleatórios.
promptobrigatório
Tipostring
Prompt utilizado para orientar o remix da imagem.
image_urlobrigatório image
Tipourl · image
URL da imagem a ser remisturada.
strengthopcional
Tiponumber
Predefinição0.8
0,01 – 1
Influência da imagem de origem no remix.
image_sizeopcional
Tipoobject
Predefiniçãosquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Resolução a utilizar para a imagem de saída.
negative_promptopcional
Tipostring
Predefinição
Especifique conteúdo de imagem indesejado, ficando as descrições do prompt principal com prioridade sobre estas descrições do prompt negativo.
reference_image_urlsobrigatório
Tipourl[] · image
Imagens de referência de personagens nos formatos JPEG, PNG ou WebP, com um limite combinado de 10 MB para todas as referências de personagens. O suporte está atualmente limitado a 1 imagem; as imagens adicionais são ignoradas.
reference_mask_urlsopcional
Tipourl[] · image
Máscaras de referência de personagens nos formatos JPEG, PNG ou WebP; o tamanho total de todas as referências de personagens não pode exceder 10 MB. Atualmente é utilizada apenas 1 máscara; as máscaras adicionais são ignoradas.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/character/remix",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 150,
    "usd": "0.15",
    "charged": 150,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    ],
    "seed": 42
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
images
array of object {url, content_type, file_name, file_size}
seed
integerValor da seed utilizado para a geração de números aleatórios.

Mais modelos: Edição de imagem

Para agentes de IA: esta página em Markdown está disponível em https://doitong.com/pt-PT/developers/models/ideogram/character/remix.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt