Avançar para o conteúdo

Hidream O1 Image

Integrar

ID do modelo hidream-o1-image
# 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?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,01 $ 10 créditos da API Executar nesta página

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

Modelo HiDream de texto para imagem com todos os passos, que também aceita imagens de referência opcionais para edição ou personalização de sujeitos

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 50

Número de passos de remoção de ruído a executar.

predefinição 5

Escala para orientação sem classificador; predefinida como 5.0 para o modelo completo.

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

POST /run/hidream-o1-image?wait=20 cotação → 0,01 $
# 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?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

Gera imagens a partir de um `prompt`, com `reference_image_urls` opcional: nenhuma para texto para imagem simples, uma para edição e várias para personalização orientada por sujeito. Usa por predefinição 50 passos de redução de ruído e escala de orientação 5. A saída chega a cerca de 2048x2048, com 1 a 4 imagens por pedido 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ção50
1 – 50
Número de passos de remoção de ruído a executar.
guidance_scaleopcional
Tiponumber
Predefinição5
0 – 20
Escala para orientação sem classificador; predefinida como 5.0 para o modelo completo.
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",
  "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": 10,
    "usd": "0.01",
    "charged": 10,
    "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.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt