Imagem a imagem

POST /v3/generation/image-to-image

Gere uma nova imagem a partir de uma imagem de referência.

Parâmetros de solicitação

Solicitar cabeçalhos

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
Content-Type	cadeia	Sim	-	`application/json`
Authorization	cadeia	Sim	-	`Bearer {api_key}`

Corpo da Solicitação

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
input	cadeia	Sim	-	Imagem de referência. Suporta `file_token`, uma imagem URL ou `task_id`
inputs	sequência[]	Não	-	Lista de múltiplas imagens de referência. Os modelos `seedream` suportam até 4 imagens e os modelos `banana` suportam até 10 imagens. Você pode fazer referência a uma imagem específica em `prompt` usando `[image number]`
prompt	cadeia	Requerido condicionalmente	-	Instrução de edição de imagem. Obrigatório quando `template` não é especificado
model	cadeia	Não	`seedream_v5`	Modelo de imagem. Valores suportados: `seedream_v5`, `banana`, `banana_pro`, `banana2`, `chat_image_1`, `chat_image_1.5`, `chat_image_2`, `chat_image_2.5_flare`, `chat_image_2.5_sunburst`
quality	cadeia	Não	`low`	Nível de qualidade. Apenas `chat_image_2` (`low`, `medium`, `high`) e `chat_image_2.5_flare` / `chat_image_2.5_sunburst` (mais `xhigh`, `max`). Omitir equivale a `low`; `auto` não é suportado. `high`/`xhigh`/`max` custam mais créditos.
background	cadeia	Não	-	Tratamento do fundo. Apenas `chat_image_2.5_flare` / `chat_image_2.5_sunburst`: `auto`, `opaque`, `transparent`. Com outros modelos é ignorado em vez de rejeitado. `transparent` exige `output_format=png` (JPEG não tem canal alfa).
template	cadeia	Não	-	Nome do modelo. Valores suportados: `asset_extraction`, `character_completion`, `t_pose`, `head_extraction`, `3d_enhance`, `variants`, `print_clay`, `figure`
t_pose	booleano	Não	`false`	Converter para pose T
sketch_to_render	booleano	Não	`false`	Converter um esboço em uma imagem renderizada

Exemplos de solicitação

curl -X POST https://openapi.tripo3d.ai/v3/generation/image-to-image \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "https://example.com/reference.png",
    "prompt": "Replace the background with a starry sky",
    "model": "seedream-v4"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/generation/image-to-image"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "https://example.com/reference.png",
    "prompt": "Replace the background with a starry sky",
    "model": "seedream-v4"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const url = "https://openapi.tripo3d.ai/v3/generation/image-to-image";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "https://example.com/reference.png",
    prompt: "Replace the background with a starry sky",
    model: "seedream-v4"
  })
});

const data = await response.json();
console.log(data);

Resposta

Resposta de sucesso

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"
  }
}

Campos de resposta

Parâmetro	Tipo	Descrição
code	inteiro	Código de status. `0` indica sucesso
data.task_id	cadeia	Identificador de tarefa exclusivo usado para consultar o progresso e os resultados da geração

Códigos de erro

Código de status HTTP	Código de erro	Descrição	Recomendação
429	2000	Limite de geração excedido	Reduza a frequência de solicitações e tente novamente mais tarde
400	2002	Parâmetro de solicitação não compatível	Verifique os nomes dos parâmetros do corpo da solicitação e os intervalos de valores
400	2003	O arquivo de entrada está vazio	Confirme se `input` aponta para um recurso de imagem válido
400	2004	Tipo de arquivo não suportado	Use um formato de imagem compatível (PNG, JPEG, WebP)
400	2008	A entrada viola a política de conteúdo	Revise a imagem ou prompt de entrada e remova as descrições que violam a política
403	2010	Créditos insuficientes	Adicione créditos e tente novamente
400	2015	Versão do modelo obsoleta	Atualize `model` para uma versão atualmente suportada