Appearance
API 调用与调试
即梦模型的 API 接口说明和常见问题排查
接口概览
即梦模型使用 OpenAI 兼容接口:
- Base URL:
https://aiapi.fhddos.com - 认证方式:
Authorization: Bearer YOUR_API_KEY
支持的接口:
- 文生图:
POST /v1/images/generations - 图生图:
POST /v1/images/edits
提示:即梦系列(4.0 / 3.0 / agent)按次计费(0.8 RMB/次)并固定生成 4 张图片;
文生图接口
model string 必填模型名称:
jimeng-4.0 / jimeng-3.0 / jimeng-agentprompt string 必填文本描述(支持中英文)
n integer 默认 4生成数量。即梦系列(4.0 / 3.0 / agent)固定生成 4 张。
size string 默认 1024x1024分辨率:
1024x1024 / 1024x1792 / 1792x1024response_format string 默认 url返回格式
请求示例
bash
curl https://aiapi.fhddos.com/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "jimeng-4.0",
"prompt": "一只可爱的熊猫在图书馆看书",
"n": 1,
"size": "1024x1024"
}'python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://aiapi.fhddos.com/v1"
)
response = client.images.generate(
model="jimeng-4.0",
prompt="一只可爱的熊猫在图书馆看书",
n=1,
size="1024x1024"
)
print(response.data[0].url)响应示例
json
{
"created": 1700000000,
"data": [
{
"url": "https://cdn.example.com/images/abc123.png"
}
]
}图生图接口
使用 multipart/form-data 格式上传图片。
image file 必填原始图片文件(PNG/JPEG)
model string 必填模型名称
prompt string修改描述
n integer 默认 1生成数量
请求示例
bash
curl https://aiapi.fhddos.com/v1/images/edits \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@input.png" \
-F "model=jimeng-4.0" \
-F "prompt=添加科幻元素" \
-F "n=1"python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://aiapi.fhddos.com/v1"
)
with open("input.png", "rb") as image_file:
response = client.images.edit(
image=image_file,
model="jimeng-4.0",
prompt="添加科幻元素",
n=1
)
print(response.data[0].url)