Avançar para o conteúdo

Image Editing Scene Composition

Integrar

ID do modelo image-editing/scene-composition
# 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/image-editing/scene-composition?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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,04 $ 40 créditos da API · ≈ 4,22 ₽ Executar nesta página

Obter chave de API
Utility · 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.

predefinição enchanted forest

Descrição da cena na qual colocar o objeto.

•obrigatório image_url
Largue um ficheiro ou

Imagem utilizada para fornecer o prompt ao modelo omni.

aspect_ratio

Proporção da imagem resultante.

Avançado safety_tolerance · output_format · guidance_scale · num_inference_steps · seed
safety_tolerance predefinição 2

Definição de segurança para imagens geradas: escolha 6 para a filtragem mais permissiva ou 1 para a mais rigorosa.

output_format predefinição jpeg

Formato de ficheiro da imagem resultante.

predefinição 3.5

Intensidade de adesão ao prompt para seleção de imagens, expressa como CFG (Classifier Free Guidance).

predefinição 30

Número de passos de inferência usados durante a amostragem.

Seed para imagens reproduzíveis: um prompt e uma seed idênticos produzem uma imagem idêntica quando a versão do modelo não é alterada.

POST /run/image-editing/scene-composition?wait=20 cotação → 0,04 $
# 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/image-editing/scene-composition?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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 Image Editing Scene Composition

Coloca o sujeito de `image_url` num cenário descrito em `prompt`, que por predefinição é "enchanted forest". A iluminação e a composição são adaptadas à nova cena. As entradas adicionais incluem `guidance_scale`, `num_inference_steps` (1 a 50), saída jpeg ou png, `aspect_ratio` e `seed`.

Parâmetros

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

NomeTipo PredefiniçãoPermitido Descrição
image_urlobrigatório image
Tipourl · image
Imagem utilizada para fornecer o prompt ao modelo omni.
guidance_scaleopcional
Tiponumber
Predefinição3.5
0 – 20
Intensidade de adesão ao prompt para seleção de imagens, expressa como CFG (Classifier Free Guidance).
num_inference_stepsopcional
Tipointeger
Predefinição30
1 – 50
Número de passos de inferência usados durante a amostragem.
safety_toleranceopcional
Tipoenum
Predefinição2
123456
Definição de segurança para imagens geradas: escolha 6 para a filtragem mais permissiva ou 1 para a mais rigorosa.
output_formatopcional
Tipoenum
Predefiniçãojpeg
jpegpng
Formato de ficheiro da imagem resultante.
aspect_ratioopcional
Tipoenum
21:916:94:33:21:12:33:49:169:21
Proporção da imagem resultante.
seedopcional
Tipointeger | null
Seed para imagens reproduzíveis: um prompt e uma seed idênticos produzem uma imagem idêntica quando a versão do modelo não é alterada.
promptopcional
Tipostring
Predefiniçãoenchanted forest
Descrição da cena na qual colocar o objeto.
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": "image-editing/scene-composition",
  "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": 40,
    "usd": "0.04",
    "charged": 40,
    "refunded": 0
  },
  "input": {
    "image_url": "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,
        "width": 1024,
        "height": 768
      }
    ],
    "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, width, height}
seed
integer

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/image-editing/scene-composition.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt