图片

FastSkills 图片接口提供生图和编辑图片能力。

接口说明

• 生图接口：POST https://api-hw.fastskills.ai/v1/images/generations
• 编辑图片接口：POST https://api-hw.fastskills.ai/v1/images/edits
• 鉴权方式：Authorization: Bearer sk-开头的密钥
• 示例模型：gpt-image-2

危险

不要把真实 API Key 写入公开仓库、前端代码、日志或截图。

生图

生图接口使用 JSON 请求体。下面示例会生成一张白底商业产品图，返回图片 URL。

curl https://api-hw.fastskills.ai/v1/images/generations \
  -H "Authorization: Bearer sk-开头的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张简洁的商业产品图，白底图，一件粉红色和白色相间的碎花短裙，光线柔和，细节清晰。",
    "size": "1024x1024",
    "quality": "medium",
    "response_format": "url"
  }'

生图结果示例

生成结果示例文件：skirt.png

编辑图片

编辑图片接口使用 multipart/form-data。下面示例传入两张图片：第一张是女模特图，第二张是短裙图，目标是把女模特身上的长裙替换成短裙，并保留真实阴影。

curl https://api-hw.fastskills.ai/v1/images/edits \
  -H "Authorization: Bearer sk-开头的密钥" \
  -F "model=gpt-image-2" \
  -F "prompt=将第一张图中女模特的长裙替换成第二张图中的碎花短裙，保留真实阴影。" \
  -F "size=1024x1536" \
  -F "quality=high" \
  -F "response_format=url" \
  -F "image=@girl-model.png" \
  -F "image=@skirt.png"

编辑图片示例

输入图 1	输入图 2	编辑结果

字段说明

字段	接口	必填	说明
model	生图 / 编辑	是	图片模型名，示例为 gpt-image-2。
prompt	生图 / 编辑	是	图片生成或编辑指令。
size	生图 / 编辑	是	输出尺寸，例如 1024x1024、1024x1536。
quality	生图 / 编辑	否	输出质量，例如 medium、high。
response_format	生图 / 编辑	否	返回格式，当前示例使用 url。
image	编辑	是	参考图片，可传多个 image 字段。

调用建议

• 生图使用 application/json。
• 编辑图片使用 multipart/form-data，并按顺序传入参考图片。
• 当前示例为同步接口，请在请求超时时间上预留足够时间。