Avançar para o conteúdo

Phota

Integrar

ID do modelo phota/edit
# 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/phota/edit?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",
    "images": [
      "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

Obter chave de API
Open model Edição de imagem Saída em 4Katé 4K #edit#personalization#typography#phota

Edição de fotografias preservando a identidade a partir de 1 a 10 imagens de entrada, com perfis treinados opcionais

Open model · 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 88 / 8000

Prompt de geração de imagem que pode incluir referências a perfis como [[profile_id_1]] e [[profile_id_2]], juntamente com uma descrição do que criar.

•obrigatório image_urls
Largue um ficheiro ou

Imagens a editar, fornecidas como URLs ou data URIs Base64; as entradas após as primeiras 10 são ignoradas. Forneça pelo menos uma imagem ou use o endpoint `/` para gerar apenas a partir de texto.

resolution predefinição 1K

Resolução a usar para a imagem gerada.

aspect_ratio predefinição auto

Proporção entre a largura e a altura da imagem de saída.

num_images predefinição 1

Número de imagens a produzir.

Avançado output_format · base_model · enable_safety_checker · profile_ids
output_format predefinição jpeg

Formato de ficheiro da imagem resultante.

base_model predefinição nb2

Seleção do modelo de renderização, com `4K` disponível apenas através de `nb2`. As camadas de identidade são aplicadas sobre qualquer modelo base selecionado, tornando todas as escolhas compatíveis com perfis treinados.

Seleção de perfis para geração de imagens, fornecida como uma lista de IDs; o prompt pode identificar estes perfis com @Profile1, @Profile2 e assim sucessivamente.

POST /run/phota/edit?wait=20 cotação → 0,09 $
# 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/phota/edit?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",
    "images": [
      "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.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 Phota

Edita fotografias existentes a partir de um `prompt` de até 8000 caracteres e de `image_urls`, que requer pelo menos uma imagem; são utilizadas no máximo 10. Forneça `profile_ids` para manter pessoas específicas reconhecíveis. `base_model` pode ser nb2, qwen-image-2, flux-2 ou seedream-5-pro, e a saída 4K funciona apenas com nb2. Devolve 1 a 4 imagens em JPEG ou PNG.

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
≤ 8000 caracteres
Prompt de geração de imagem que pode incluir referências a perfis como [[profile_id_1]] e [[profile_id_2]], juntamente com uma descrição do que criar.
num_imagesopcional num_outputs
Tipointeger
Predefinição1
1 – 4
Número de imagens a produzir.
profile_idsopcional
Tipostring[]
Seleção de perfis para geração de imagens, fornecida como uma lista de IDs; o prompt pode identificar estes perfis com @Profile1, @Profile2 e assim sucessivamente.
output_formatopcional
Tipoenum
Predefiniçãojpeg
jpegpng
Formato de ficheiro da imagem resultante.
resolutionopcional
Tipoenum
Predefinição1K
1K4K
Resolução a usar para a imagem gerada.
aspect_ratioopcional
Tipoenum
Predefiniçãoauto
auto1:116:94:33:49:16
Proporção entre a largura e a altura da imagem de saída.
base_modelopcional
Tipoenum
Predefiniçãonb2
nb2qwen-image-2flux-2seedream-5-pro
Seleção do modelo de renderização, com `4K` disponível apenas através de `nb2`. As camadas de identidade são aplicadas sobre qualquer modelo base selecionado, tornando todas as escolhas compatíveis com perfis treinados.
image_urlsobrigatório images
Tipourl[] · image
Imagens a editar, fornecidas como URLs ou data URIs Base64; as entradas após as primeiras 10 são ignoradas. Forneça pelo menos uma imagem ou use o endpoint `/` para gerar apenas a partir de texto.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
A filtragem pode ser flexibilizada definindo false, desde que o autor do pedido esteja autorizado.
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": "phota/edit",
  "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": 90,
    "usd": "0.09",
    "charged": 90,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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,
        "width": 1024,
        "height": 768
      }
    ]
  },
  "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}URL que aponta para a imagem editada.

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/phota/edit.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt