Developer Platform
开发者平台几行代码,把 平台模型
接进你的业务
统一 RESTful API、异步任务模型、Webhook 回调、透明限流——团队版专属能力,按量计费,随业务弹性伸缩。
多协议
统一接入
1
套 API 标准
30 req/min
付费限流
3
语言示例
API 特性
为生产环境设计
从鉴权到回调,一套完整、可观测的生成 API。
01
API Key 鉴权
在账户设置中生成专属 API Key,请求头携带即可调用,支持随时轮换与吊销。
02
异步任务模型
提交任务立即返回 task_id,通过查询接口或 Webhook 获取结果,适配高并发场景。
03
结果回调通知
配置 Webhook 地址,任务完成后自动推送结果 URL,无需轮询。
04
文档与示例
覆盖文生图、图生图、视频生成全部端点,附 curl、Node.js、Python 示例。
快速开始
5 分钟完成第一次调用
标准 RESTful 风格,JSON 请求与响应,任何语言都能快速集成。
POST
/v1/images/generatePOST
/v1/images/upscalePOST
/v1/images/mattingPOST
/v1/videos/generatePOST
/v1/videos/stylizeGET
/v1/tasks/:idGET
/v1/modelsterminal
curl -X POST https://api.yunheng.ai/v1/images/generate \
-H "Authorization: Bearer $YUNHENG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "赛博朋克城市夜景,霓虹灯光,电影级画质",
"model": "FLUX.2 Pro",
"size": "1024x1024",
"quality": "hd"
}'
# 响应
{
"task_id": "task_8f3k2m9x",
"status": "queued"
}node.js
const res = await fetch("https://api.yunheng.ai/v1/images/generate", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.YUNHENG_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
prompt: "一杯拿铁,清晨窗边,商业摄影",
model: "FLUX.2 Pro",
size: "1024x1024",
}),
});
const { task_id } = await res.json();
// 轮询任务状态
const task = await (
await fetch(`https://api.yunheng.ai/v1/tasks/${task_id}`, {
headers: { Authorization: `Bearer ${process.env.YUNHENG_API_KEY}` },
})
).json();
console.log(task.status, task.result?.url);python
import requests
resp = requests.post(
"https://api.yunheng.ai/v1/videos/generate",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={
"prompt": "无人机航拍雪山日出,电影感",
"model": "Seedance 2.0",
"duration": 10,
"resolution": "1080p",
"camera_control": "orbit",
},
)
task_id = resp.json()["task_id"]
# 查询结果(或配置 Webhook 自动接收)
task = requests.get(
f"https://api.yunheng.ai/v1/tasks/{task_id}",
headers={"Authorization": f"Bearer {API_KEY}"},
).json()
print(task["status"], task.get("result", {}).get("url"))异步任务
从提交到回调,四步走完
任务入队、异步处理、结果就绪,可查询也可等 Webhook 推送。
01
STEP 01
提交任务
POST 到生成端点,携带 API Key 与参数
02
STEP 02
入队处理
返回 task_id,任务进入 BullMQ 队列
03
STEP 03
结果就绪
查询接口返回 completed 与结果 URL
04
STEP 04
Webhook 通知
(可选)结果自动推送到你的回调地址
限流与配额
稳定可控的调用节奏
按套餐提供差异化限流,生产环境更从容。
| 套餐 | 限流 | 适用场景 |
|---|---|---|
| 免费版 | 10 请求/分钟 | 体验与测试 |
| 付费版(创作者/专业/团队) | 30 请求/分钟 | 生产环境建议 |
| 私有化部署 | 自定义 | 按企业负载配置 |
具体限流以账户实际配置为准,团队版及以上可申请提升配额。
常见问题
开发者常见问题
与站内生成共用算力体系,按任务实际消耗扣减团队算力池,单价见定价页计费规则。
