文档

生成图像

给一句提示词,拿回图片。需要按文字描述出图时用这个接口,OpenAI 格式,现有 SDK 换个地址就能调。

POST https://open.feiyutoken.com/v1/images/generations

请求参数

参数 类型 必填 说明
prompt string 是 图像的文本描述,也就是提示词
model string 否 模型名,沿用厂商官方命名;可用值见模型列表
n integer 否 生成几张图
size string 否 输出尺寸,写法如 1024x1024;可用档位取决于模型
quality string 否 生成质量档位,可取值取决于模型
background string 否 背景处理方式,需要透明背景时用得上;仅部分模型支持
moderation string 否 内容审核级别;仅部分模型支持
style string 否 风格取向,可取值取决于模型
user string 否 调用方的最终用户标识,便于按业务侧用户区分用量

其余 OpenAI 标准参数按原样透传。

不同厂商的图像模型走同一个地址,按 model 区分。部分厂商在这个 路径上使用自己的专有字段,一并放在请求体里即可,字段含义以模型厂商的接口说明为准。

请求示例

curl https://open.feiyutoken.com/v1/images/generations \
  -H "Authorization: Bearer <你的飞鱼Token API Key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名>",
    "prompt": "一只戴贝雷帽的海獭,浅色背景,插画风格",
    "n": 1,
    "size": "1024x1024"
  }'

响应

{
  "created": 1770000000,
  "data": [
    {
      "url": "https://..."
    }
  ],
  "usage": {
    "total_tokens": 100,
    "input_tokens": 20,
    "output_tokens": 80,
    "input_tokens_details": {
      "text_tokens": 20,
      "image_tokens": 80
    }
  }
}

data 每一项是一张图:可能是可访问的图片地址(url),也可能是 base64 编码的 图片内容(b64_json),由模型与请求参数决定 —— 拿到 URL 后请尽早落盘或转存。

计费与用量

图像按张数或分辨率计费(与模型厂商官网一致),费用从账户余额扣减。调用记录与消费明细在控制台可以按模型、 按 Key、按时间查看。