curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "hy-image-v3.5-preview",
"prompt": "画一只在沙滩上奔跑的金毛犬，傍晚的暖色光",
"size": "16:9",
"resolution": "2K"
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/images/generations",
headers={"Authorization": "Bearer <token>"},
json={
"model": "hy-image-v3.5-preview",
"prompt": "画一只在沙滩上奔跑的金毛犬，傍晚的暖色光",
"size": "16:9",
"resolution": "2K"
}
)
response.raise_for_status()
print(response.json())
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
method: "POST",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "hy-image-v3.5-preview",
prompt: "画一只在沙滩上奔跑的金毛犬，傍晚的暖色光",
size: "16:9",
resolution: "2K"
})
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01K..."
}
]
}
Hy-Image-3.5 Preview
Hy-Image-3.5 Preview 图像生成
支持文生图、最多 5 张参考图、1K / 2K / 4K 输出及精确像素尺寸，每次生成 1 张图片。
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "hy-image-v3.5-preview",
"prompt": "画一只在沙滩上奔跑的金毛犬，傍晚的暖色光",
"size": "16:9",
"resolution": "2K"
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/images/generations",
headers={"Authorization": "Bearer <token>"},
json={
"model": "hy-image-v3.5-preview",
"prompt": "画一只在沙滩上奔跑的金毛犬，傍晚的暖色光",
"size": "16:9",
"resolution": "2K"
}
)
response.raise_for_status()
print(response.json())
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
method: "POST",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "hy-image-v3.5-preview",
prompt: "画一只在沙滩上奔跑的金毛犬，傍晚的暖色光",
size: "16:9",
resolution: "2K"
})
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01K..."
}
]
}
本接口采用异步处理。提交成功后，从
data[0].task_id 获取任务 ID，通过 任务查询 获取状态和图片。建议每 3–5 秒轮询一次，客户端整体等待超时设为 5 分钟；状态为 completed 或 failed 时停止轮询。curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "hy-image-v3.5-preview",
"prompt": "画一只在沙滩上奔跑的金毛犬，傍晚的暖色光",
"size": "16:9",
"resolution": "2K"
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/images/generations",
headers={"Authorization": "Bearer <token>"},
json={
"model": "hy-image-v3.5-preview",
"prompt": "画一只在沙滩上奔跑的金毛犬，傍晚的暖色光",
"size": "16:9",
"resolution": "2K"
}
)
response.raise_for_status()
print(response.json())
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
method: "POST",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "hy-image-v3.5-preview",
prompt: "画一只在沙滩上奔跑的金毛犬，傍晚的暖色光",
size: "16:9",
resolution: "2K"
})
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01K..."
}
]
}
请求头
string
必填
Bearer 认证，格式为
Bearer <token>，其中 <token> 为你的 APIMart API Key。请求参数
string
必填
固定为
hy-image-v3.5-preview。string
必填
图片生成或编辑的文本描述，支持中文和英文，不能为空。
string
默认值:"auto"
输出宽高比或精确像素尺寸。
- 宽高比：
1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。 - 精确像素：例如
2000x1104，须满足下方像素限制。 auto或不传：由模型根据提示词决定比例。
resolution 不参与尺寸选择。string
默认值:"1K"
输出分辨率档位：
1K、2K 或 4K，默认 1K。指定精确像素尺寸时，此字段不参与尺寸选择。请始终使用上述支持的值，不支持的值会返回 HTTP 400。integer
精确输出宽度，单位为像素。必须与
height 成对传入，优先级高于 size 和 resolution。宽度须在 256–8192 之间，且宽 × 高不超过 8,294,400；建议使用 16 的倍数。integer
精确输出高度，单位为像素。必须与
width 成对传入。高度须在 256–8192 之间，且宽 × 高不超过 8,294,400；建议使用 16 的倍数。string[]
参考图片的公网 URL 列表，最多 5 张。不传为文生图，传入则为参考图生图，使用同一接口。图片支持 JPEG、PNG、WEBP，单张建议小于 7MB。URL 必须可从公网访问。
string
不希望出现在图片中的内容。
integer
随机种子，必须为非负整数。传
0 或不传时随机生成。integer
默认值:"1"
每次只生成 1 张图片，只能传
1。其他值会返回 HTTP 400。尺寸选择
尺寸参数优先级：成对的width / height → size 精确像素 → size 宽高比或 auto 搭配 resolution。
精确像素的宽、高各为 256–8192，总像素不超过 8,294,400。建议宽、高均取 16 的倍数。
精确像素示例
{
"model": "hy-image-v3.5-preview",
"prompt": "简洁的海边旅行海报，暖色夕阳",
"width": 2000,
"height": 1104
}
width、height，改为传入 "size": "2000x1104"。
参考图生成示例
{
"model": "hy-image-v3.5-preview",
"prompt": "将参考图中的汽车改为红色，保留原有背景和光照",
"image_urls": ["https://example.com/car.png"],
"size": "16:9",
"resolution": "2K",
"negative_prompt": "模糊、文字水印",
"seed": 42,
"n": 1
}
image_urls 中添加地址，总数不超过 5 张。
提交响应
integer
响应状态码，成功为
200。查询任务结果
curl --request GET \
--url https://api.apimart.ai/v1/tasks/task_01K... \
--header 'Authorization: Bearer <token>'
{
"code": 200,
"data": {
"id": "task_01K...",
"status": "completed",
"result": {
"images": [
{
"url": ["https://example.com/generated-image.png"]
}
]
}
}
}
pending/processing：继续轮询。completed：从data.result.images[0].url[0]获取图片地址，url为字符串数组。failed：停止轮询，从data.error.message获取原因，费用全额退回。提示词违规或内容审核不通过也按失败处理。
expires_at 指定时间前下载保存。
计费说明
按张计费，具体价格以模型定价为准。- 使用宽高比时，按
resolution档位收费。 - 使用精确像素时，按图片短边确定档位：
| 档位 | 短边范围 |
|---|---|
| 1K | 不超过 1024 像素 |
| 2K | 1025–2048 像素 |
| 4K | 超过 2048 像素 |
常见参数错误
以下情况同步返回 HTTP 400，不创建任务、不扣费：| 情况 | 处理方式 |
|---|---|
prompt 为空 | 提供非空提示词 |
n 不为 1 | 每次只请求 1 张图片 |
seed 为负数 | 使用非负整数；0 表示随机 |
resolution 不受支持 | 使用 1K、2K 或 4K |
size 宽高比不受支持 | 使用上方列出的 10 种比例或 auto |
| 精确像素越界 | 宽、高各为 256–8192，且总像素不超过 8,294,400 |
| 参考图超过 5 张 | 将 image_urls 减少至最多 5 张 |