FLUX API

模型简介

Exchange Token 通过两条独立路径提供 FLUX 图像生成能力：

• POST /v1/flux-2-pro
• POST /v1/flux-2-max

这两个接口都采用异步调用方式。先提交任务，再通过 GET /v1/get_result?id=... 轮询结果。

调用方式

API 端点

https://api.exchangetoken.ai

认证方式

FLUX 接口使用以下认证头：

x-key: YOUR_API_KEY

请求格式

Content-Type: application/json

提交图像生成任务

请求路径

• POST /v1/flux-2-pro
• POST /v1/flux-2-max

请求示例

curl -X POST "https://api.exchangetoken.ai/v1/flux-2-pro" \
  -H "x-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic portrait of a silver robot walking in neon rain",
    "width": 1024,
    "height": 1024,
    "seed": 42,
    "safety_tolerance": 2,
    "output_format": "png"
  }'

提交响应

提交成功后会返回任务 ID：

{
  "id": "sg_img_123456"
}

查询任务结果

请求路径

GET /v1/get_result?id=TASK_ID

请求示例

curl "https://api.exchangetoken.ai/v1/get_result?id=sg_img_123456" \
  -H "x-key: YOUR_API_KEY"

处理中响应示例

{
  "id": "sg_img_123456",
  "status": "Pending",
  "progress": "45"
}

完成响应示例

{
  "id": "sg_img_123456",
  "status": "Ready",
  "output": [
    {
      "url": "https://cdn.example.com/generated-image.png"
    }
  ]
}

失败响应示例

{
  "id": "sg_img_123456",
  "status": "Error",
  "error": {
    "code": "RUNTIME_CREATE_PROVIDER_FAILED",
    "message": "image generation failed"
  }
}

常用参数

参数	类型	必填	说明
prompt	string	是	图像生成或编辑提示词
input_image	string	否	第一张输入图
input_image_2 到 input_image_8	string	否	更多输入图，最多 8 张
seed	integer	否	可选随机种子，用于复现结果
width	integer	否	输出宽度，最小值 64
height	integer	否	输出高度，最小值 64
safety_tolerance	integer	否	取值范围 0 到 5
output_format	string	否	支持 jpeg、png

状态值

当前 FLUX 查询接口返回以下任务状态：

• Pending
• Ready
• Error

说明

• 如果需要多张参考图，请在同一个 JSON body 中传 input_image 以及 input_image_2 到 input_image_8。
• 使用同一个任务 ID 持续轮询，直到 status 变为 Ready 或 Error。