Imagens

A geração de imagens é representada na navegação de documentos para que os documentos estrangeiros mantenham um mapa de produtos consistente. A disponibilidade de endpoints públicos no exterior é orientada por esquema. Verifique GET /api/openapi.json antes de chamar os endpoints de imagem do código de produção.

Solicitar

Quando os pontos de extremidade de imagem estiverem habilitados, espere um modelo de tarefa assíncrona: crie uma tarefa com um prompt e opções de modelo e, em seguida, pesquise a conclusão. As solicitações ainda usam autenticação de portador:

Authorization: Bearer KITTA_API_KEY

Não infira caminhos estrangeiros de outros documentos. Use apenas caminhos presentes no esquema OpenAPI externo para o ambiente implementado.

Resposta

As respostas da tarefa de imagem normalmente incluem ID da tarefa, status, URL da imagem de resultado em caso de sucesso e um código de erro em caso de falha. Armazene o ID da tarefa antes da sondagem para que os usuários possam recuperar o resultado após a atualização da página ou reinicialização do trabalhador.

Faturamento e créditos

A geração de imagens pode ser cobrada por modelo, resolução, imagens de referência ou tarefa bem-sucedida. Valide o tamanho do prompt e a mídia de entrada antes de criar uma tarefa e verifique o Perfil antes de lotes grandes.

Erros

Lide com modelo não suportado, imagem de referência inválida, créditos insuficientes e falha de processamento separadamente. Se os endpoints de imagem estiverem ausentes em GET /api/openapi.json, trate o recurso como não disponível publicamente para a conta.

Endpoints OpenAPI canônicos

• Listar modelos: GET /api/open/v1/media/models?mediaType=image
• Gerar imagem: POST /api/open/v1/media/images/jobs
• Consultar tarefa: GET /api/open/v1/media/images/jobs/{jobId}

Cada solicitação de criação deve incluir um cabeçalho Idempotency-Key exclusivo. A API usa cota de API, não créditos da assinatura web, e reembolsa a cota de forma idempotente se houver falha do provedor, armazenamento ou persistência.