Modelos de imagemUsuários avançadosAtualizado em
POST/v1/images/generations

Console da API

POST/v1/images/generations
Ver chaves

As requisições usam a chave informada e seguem a cobrança padrão da API.

FLUX 2 Pro

ID da solicitação flux-2-pro

Protocolos

Autenticação

Obtenha uma chave em Gerenciar chaves de API. Para requisições JSON, defina Content-Type: application/json.

  • Authorization: Bearer YOUR_API_KEY

Parâmetros da requisição

POST /v1/images/generations

CampoTipoObrigatórioDescrição
modelstringObrigatórioUse este ID de modelo flux-2-pro.
promptstringObrigatórioDescreva a imagem a gerar.
sizestringOpcionalInforme as dimensões em pixels no formato larguraxaltura, como 1536x1024. Padrão 1024x1024. Cada lado deve ter pelo menos 64 pixels. A saída tem limite de 4 MP, e a soma da saída e das referências, de 9 MP.
seedintegerOpcionalSemente aleatória de 0 a 4294967295.
nintegerOpcionalUma imagem por solicitação. Padrão 1.
image_urlsstring[]OpcionalLista JSON de imagens de referência. Cada item é uma URL HTTPS pública ou uma URL de dados de imagem em Base64. Também aceita image_input. Máximo de imagens de referência 8.
?asyncstringOpcionalParâmetro de consulta da URL. Use 1, true ou yes para receber 202 e task_id. Omita para aguardar o resultado.

Exemplos de requisição

Defina a chave de API na variável de ambiente local ICODEEASY_API_KEY e escolha um endpoint que aceite chamadas HTTP diretas. Caso o endpoint exija um cliente específico, siga o guia de configuração desse cliente.

Substitua as URLs e os IDs de mídia dos exemplos por ativos válidos.

Images Generations

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "flux-2-pro",
  "prompt": "A watercolor illustration of a paper lantern by a lake."
}'

Consultar tarefa de imagem

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

Respostas e tarefas

HTTP 200 · Sucesso síncrono

Com ?sync=1, leia as URLs geradas em data[].url. created é um timestamp Unix em segundos e id é o ID da tarefa.

json
{
  "id": "d142c93a-de26-40c9-be62-0de840d10960",
  "created": 1781599773,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

HTTP 202 · Envio assíncrono

json
{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "pending"
}

Com ?async=1, consulte GET /v1/images/tasks/{task_id} com a mesma chave de API. status é pending, completed ou failed. Quando a tarefa concluir, leia a URL da imagem em result_url.

HTTP 200 · Consulta de tarefa concluída

json
{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "completed",
  "model": "flux-2-pro",
  "result_url": "https://example.com/generated-image.png"
}

Erros comuns

Se a consulta retornar failed, leia error. Se houver error_detail, confira retryable antes de enviar novamente.

Exemplos de resposta e erros

Guia completo de integração · Consulte o guia completo da API para ver os campos, estados de tarefas e formatos de resposta.

Recursos e limites

  • text_to_image · Compatível
  • image_to_image · Condicional — Requer imagens de referência válidas em um formato de solicitação compatível
  • image_editing · Não publicado
  • reference_images · Condicional — Requer imagens de referência válidas em um formato de solicitação compatível

Aliases de compatibilidade e redirecionamentos aposentados

  • flux.2-pro → flux-2-pro (Alias)

Catálogo de recursos dos modelos · Ver preços

Guias relacionados

API de geração de imagens

Gere ou edite imagens com a API compatível com OpenAI. Envie prompts, dimensões e imagens de referência e consulte os resultados ou o status das tarefas assíncronas.

Catálogo de recursos dos modelos

Compare modelos públicos de texto, imagem e vídeo por ID normalizado, protocolos, clientes, ferramentas, recursos de mídia, limites e data de revisão.

Criar conta e obter uma API Key