Avançar para o conteúdo

Hidream O1 Image · Dev

Integrar

ID do modelo hidream-o1-image/dev
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hidream-o1-image/dev?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"
  }'

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

Este pedido: 0,005 $ 5 créditos da API Executar nesta página

Obter chave de API
HiDream Texto para imagem Entradas de referência

Variante HiDream de texto para imagem destilada em 28 passos, com orientação desativada por predefinição e imagens de referência opcionais

HiDream · 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

Instruções de texto para gerar ou editar imagens, ou para personalização orientada pelo sujeito.

image_size predefinição {"height":1024,"width...

Dimensões da saída com um limite aproximado de 2048 × 2048 píxeis; cada dimensão solicitada é reduzida para o múltiplo de 32 mais próximo.

num_images predefinição 1

Número de imagens a produzir.

Avançado images · output_format · num_inference_steps · guidance_scale · seed · enable_safety_checker · keep_original_aspect
reference_image_urls predefinição []
Largue um ficheiro ou

Imagens de referência para edição (uma imagem) ou personalização orientada pelo sujeito (várias imagens); omita-as para geração de texto para imagem.

output_format predefinição png

Formato de ficheiro da imagem resultante.

predefinição 28

Número de iterações de redução de ruído, com 28 passos a corresponder ao objetivo de destilação do modelo dev.

predefinição 0

Escala para orientação sem classificador; predefinida como 0.0 para o modelo dev.

Seed aleatória que torna a geração reproduzível.

POST /run/hidream-o1-image/dev?wait=20 cotação → 0,005 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hidream-o1-image/dev?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"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/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 Hidream O1 Image · Dev

A versão dev do modelo é destilada para 28 passos, pelo que `num_inference_steps` tem o limite de 28 e `guidance_scale` usa 0 por predefinição. Continua a aceitar um `prompt` e `reference_image_urls` opcionais para edição ou personalização. O tamanho da saída chega a cerca de 2048x2048, com 1 a 4 imagens por chamada em png, jpeg ou webp.

Parâmetros

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

NomeTipo PredefiniçãoPermitido Descrição
promptobrigatório
Tipostring
Instruções de texto para gerar ou editar imagens, ou para personalização orientada pelo sujeito.
reference_image_urlsopcional images
Tipourl[] · image
Predefinição[]
Imagens de referência para edição (uma imagem) ou personalização orientada pelo sujeito (várias imagens); omita-as para geração de texto para imagem.
image_sizeopcional
Tipoobject
Predefinição{"height":1024,"width":1024}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensões da saída com um limite aproximado de 2048 × 2048 píxeis; cada dimensão solicitada é reduzida para o múltiplo de 32 mais próximo.
num_inference_stepsopcional
Tipointeger
Predefinição28
1 – 28
Número de iterações de redução de ruído, com 28 passos a corresponder ao objetivo de destilação do modelo dev.
guidance_scaleopcional
Tiponumber
Predefinição0
0 – 20
Escala para orientação sem classificador; predefinida como 0.0 para o modelo dev.
seedopcional
Tipointeger | null
Seed aleatória que torna a geração reproduzível.
num_imagesopcional num_outputs
Tipointeger
Predefinição1
1 – 4
Número de imagens a produzir.
output_formatopcional
Tipoenum
Predefiniçãopng
jpegpngwebp
Formato de ficheiro da imagem resultante.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
Controla se as imagens geradas são submetidas a verificação de segurança.
keep_original_aspectopcional
Tipoboolean
Predefiniçãofalse
Retenção da proporção para geração com uma única referência: a saída corresponde às proporções dessa referência apenas quando é fornecida exatamente uma imagem.
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": "hidream-o1-image/dev",
  "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": 5,
    "usd": "0.005",
    "charged": 5,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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,
        "width": 1024,
        "height": 768
      }
    ],
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string",
    "timings": {}
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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, width, height}Imagens produzidas pela geração.
seed
integerValor da seed aplicado durante a geração.
has_nsfw_concepts
array of booleanEstado do indicador de verificação de segurança para cada imagem gerada.
prompt
stringPrompt utilizado para gerar a saída.
timings
objectMedições de tempo da geração.

Mais modelos: Texto para imagem

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