Instruções de integração da API Flux Images Generation

​

Processo de solicitação

📘 Documentação completa: Flux Images Generation API →

​

Uso básico

• accept: qual formato de resultado de resposta deseja receber; aqui, preencha como application/json, ou seja, formato JSON.
• authorization: a chave para chamar a API; após a solicitação, é possível selecioná-la diretamente na lista suspensa.

• action: o comportamento desta tarefa de geração de imagem.
• size: o tamanho do resultado da geração de imagem. As séries flux-2-flex / flux-2-pro / flux-2-max devem receber a proporção da imagem (como 1:1, 16:9), não aceitam tamanhos em pixels como 1024x1024, e a ausência retornará 400.
• count: a quantidade de imagens geradas; o valor padrão é 1. Este parâmetro só é válido para tarefas de geração de imagem e é inválido para tarefas de edição.
• prompt: termo de prompt.
• model: modelo de geração, o padrão é flux-dev; os mais recentes modelos principais são flux-2-pro, flux-2-max (maior qualidade de imagem, requerem a proporção da imagem size).
• callback_url: a URL que precisa receber o resultado de callback.
• async: opcional; quando definido como true, a interface retorna imediatamente o task_id, sem a necessidade de fornecer callback_url; em seguida, obtenha o resultado por polling por meio da interface de consulta de tarefa correspondente.

{
  "success": true,
  "task_id": "5456c749-3bbb-4f10-9eb8-cfbcac297500",
  "trace_id": "ae4eecb8-1dd6-45b4-bfb3-a1c48872536e",
  "data": [
    {
      "image_url": "https://cdn.acedata.cloud/assets/examples/flux/5456c749-3bbb-4f10-9eb8-cfbcac297500-d0ef60485f73.jpg"
    }
  ]
}

• success, o status da tarefa de geração de vídeo neste momento.
• task_id, o ID da tarefa de geração de vídeo neste momento.
• trace_id, o ID de rastreamento da geração de vídeo neste momento.
• data, a lista de resultados da tarefa de geração de imagem neste momento.
  • image_url, o link da tarefa de geração de imagem neste momento.
  • prompt, termo de prompt.

curl -X POST 'https://api.acedata.cloud/flux/images' \
-H 'authorization: Bearer {token}' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "prompt": "A photorealistic studio product shot of a frosted-glass perfume bottle on wet black slate, single softbox key light, water droplets, dark moody background, 85mm macro.",
  "model": "flux-2-pro",
  "size": "1:1"
}'

​

Tarefa de edição de imagem

• model: o modelo adotado nesta tarefa de edição de imagem; são suportados flux-dev, flux-pro, flux-kontext-pro, flux-kontext-max, flux-2-flex, flux-2-pro, flux-2-max.
• image_url: envie a imagem que precisa ser editada.

import requests

url = "https://api.acedata.cloud/flux/images"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "action": "edit",
    "prompt": "a white siamese cat",
    "model": "flux-kontext-pro",
    "image_url": "https://cdn.acedata.cloud/ytj2qy.png"
}

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

{
  "success": true,
  "task_id": "2a7979ff-1f77-4380-92c6-a2dc37c3b4c8",
  "trace_id": "732b65c0-48d9-49f7-b568-64e5acffe4c0",
  "data": [
    {
      "prompt": "a white siamese cat",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "timings": 1752744073
    }
  ]
}

​

Retorno de chamada assíncrono

{
  "task_id": "6a97bf49-df50-4129-9e46-119aa9fca73c"
}

{
  "success": true,
  "task_id": "6a97bf49-df50-4129-9e46-119aa9fca73c",
  "trace_id": "9b4b1ff3-90f2-470f-b082-1061ec2948cc",
  "data": [
    {
      "prompt": "a white siamese cat",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "seed": 1698551532,
      "timings": {
        "inference": 3.328
      }
    }
  ]
}

​

Tratamento de erros

• 400 token_mismatched：Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
• 400 api_not_implemented：Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
• 401 invalid_token：Não autorizado, token de autorização inválido ou ausente.
• 429 too_many_requests：Muitas solicitações, você excedeu o limite de taxa.
• 500 api_error：Erro interno do servidor, algo deu errado no servidor.

​

Exemplo de resposta de erro

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​

Conclusão