Artifex API 文档
统一接口 · 多模型支持 · 按量 / 按次灵活计费
Base URL
https://artifex.help
快速开始
只需三步即可开始使用:
| 1 | 注册账号并登录 artifex.help |
| 2 | 在控制台充值并创建 API Key |
| 3 | 使用 API Key 调用接口(兼容 OpenAI SDK) |
第一个请求
curl https://artifex.help/v1/chat/completions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.4-mini", "messages": [{"role":"user","content":"Hello!"}] }'
鉴权方式
所有请求必须在 Header 中携带 API Key:
Authorization: Bearer sk-xxxxxxxxxxxxxxxx
⚠️ 请勿在前端代码或公开仓库中暴露 API Key。建议通过后端服务代理调用。
模型与定价
Token 模型按实际用量计费,次计费模型每次请求扣除固定费用。
GPT GPT-5 系列 · 对话模型
| 模型 | 输入价格 | 输出价格 | 缓存读取 | 计费 |
|---|---|---|---|---|
| gpt-5.5 | $1.25/ 1M tokens | $7.50/ 1M tokens | $0.625 / 1M | 按量 |
| gpt-5.4 | $0.626/ 1M tokens | $3.756/ 1M tokens | $0.313 / 1M | 按量 |
| gpt-5.4-mini | $0.188/ 1M tokens | $1.128/ 1M tokens | $0.094 / 1M | 按量 |
💡 Prompt Cache 自动生效,重复上下文缓存命中后按缓存价格计费(约 50% 折扣)。
Grok Grok 系列 · 对话模型
| 模型 | 特点 | 价格 | 计费 |
|---|---|---|---|
| grok-4.20-0309-non-reasoning | 支持实时 X / Twitter 数据 | $0.10/ 次 | 按次 |
图像 GPT Image 系列
| 模型 | 能力 | 价格 | 计费 |
|---|---|---|---|
| gpt-image-2-all | 文生图 · 图片编辑 · 多图合并 | $0.10/ 次 | 按次 |
| gpt-image-2-1K | 1K 分辨率 | ¥0.05/ 次 | 按次 |
| gpt-image-2-2K | 2K 分辨率 | ¥0.12/ 次 | 按次 |
| gpt-image-2-4K | 4K 分辨率 | ¥0.18/ 次 | 按次 |
| nana-banana-pro | 图像生成 | ¥0.22/ 次 | 按次 |
视频 视频生成模型
| 模型 | 能力 | 价格 | 计费 |
|---|---|---|---|
| 火山-seedance2.0 | 满血版 720p · VIP | ¥0.75/ 秒 | 按量 |
| 火山-seedance2.0-fast | 快速版 720p · VIP | ¥0.65/ 秒 | 按量 |
| SD-2.0-Fast-720P | 渠道版 快速 720p | ¥3.50/ 条 | 按次 |
| SD-2.0-Pro-720P | 渠道版 标准 720p | ¥4.50/ 条 | 按次 |
| Seedance-2.0-Fast-Beta | HKCOPP 快速 720p | ¥4.50/ 条 | 按次 |
| Seedance-2.0-Pro-Beta | HKCOPP 标准 720p | ¥8.00/ 条 | 按次 |
| Seedance-2.0-Pro-Beta-1080P | HKCOPP 标准 1080p | ¥9.50/ 条 | 按次 |
| sora-2 | 文/图生视频 12秒 | ¥0.90/ 条 | 按次 |
GPT GPT-5 系列
兼容 OpenAI Chat Completions API,可直接使用 OpenAI SDK,仅需修改 base_url。
端点
POST /v1/chat/completions
请求示例
curl https://artifex.help/v1/chat/completions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.4", "messages": [ {"role": "system", "content": "You are a helpful assistant."}, {"role": "user", "content": "用一句话解释量子纠缠"} ], "temperature": 0.7 }'
from openai import OpenAI client = OpenAI( api_key="YOUR_API_KEY", base_url="https://artifex.help/v1" ) resp = client.chat.completions.create( model="gpt-5.4", messages=[{"role": "user", "content": "用一句话解释量子纠缠"}] ) print(resp.choices[0].message.content)
可用模型
| 模型 | 上下文 | 特点 |
|---|---|---|
| gpt-5.5 | 1M tokens | 最强推理,适合复杂任务 |
| gpt-5.4 | 1M tokens | 性价比之选,通用能力强 |
| gpt-5.4-mini | 1M tokens | 轻量快速,适合简单对话 |
Grok Grok 系列
Grok 模型支持实时访问 X (Twitter) 数据,适合需要最新信息的场景。按次计费。
端点
POST /v1/chat/completions
请求示例
curl https://artifex.help/v1/chat/completions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "grok-4.20-0309-non-reasoning", "messages": [ {"role": "user", "content": "今天 X 上最热门的科技话题是什么?"} ] }'
图像 GPT Image 系列
支持文生图、图片编辑和多图合并。兼容 OpenAI Images API。
端点
POST /v1/images/generations POST /v1/images/edits
文生图示例
curl https://artifex.help/v1/images/generations \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2-all", "prompt": "一只戴着宇航员头盔的猫咪,赛博朋克风格", "n": 1, "size": "1024x1024" }'
多分辨率模型
| 模型 | 分辨率 | 价格 |
|---|---|---|
| gpt-image-2-1K | 1024x1024 | ¥0.05/ 次 |
| gpt-image-2-2K | 2048x2048 | ¥0.12/ 次 |
| gpt-image-2-4K | 4096x4096 | ¥0.18/ 次 |
| nana-banana-pro | 自适应 | ¥0.22/ 次 |
视频 Seedance 官方版(满血版)
🎬 火山引擎 Seedance 2.0 满血版,720p 视频生成,按秒计费。支持文生视频和图生视频。需开通 VIP 分组。
端点
POST /v1/videos (提交任务)
GET /v1/videos/{id} (查询状态)
GET /v1/videos/{id}/content (获取视频内容)提交任务
curl -X POST https://artifex.help/v1/videos \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "火山-seedance2.0", "prompt": "一只金毛犬在向日葵花田中奔跑,慢动作,阳光明媚的下午", "size": "1280x720", "duration": 5 }'
查询状态
curl https://artifex.help/v1/videos/{task_id} \
-H "Authorization: Bearer YOUR_API_KEY"
参数说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | ✅ | 火山-seedance2.0 或 火山-seedance2.0-fast |
prompt | string | ✅ | 视频描述(≤1500字符) |
size | string | ❌ | 如 1280x720(默认 16:9) |
duration | int | ❌ | 5~10 秒,默认 5 |
状态说明
| status | 含义 |
|---|---|
queued | 排队中 |
in_progress | 生成中 |
completed | 完成 → 取 video_url |
failed | 失败 → 查看 error |
💡 官方版按秒计费,视频分辨率固定 720p。生成通常需要 30~120 秒。
视频 Seedance 渠道版(支持真人脸)
🎬 渠道版支持真人脸生成,按条固定计费。Fast ¥3.5/条,Pro ¥4.5/条。最多支持 4 张参考图 + 3 个参考视频,总素材 ≤ 20MB。
端点
POST /v1/videos (提交任务)
GET /v1/videos/{id} (查询状态)提交任务
curl -X POST https://artifex.help/v1/videos \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "SD-2.0-Pro-720P", "prompt": "照片中的人物缓缓转向镜头微笑,电影感柔光", "duration": 5, "images": ["https://example.com/portrait.jpg"] }'
Prompt 资源引用语法
可在 prompt 中使用 @1、@2 引用上传的图片/视频素材:
"prompt": "让@1中的人物走进@2的场景中,电影感镜头", "images": ["https://cdn.example.com/person.jpg"], "videos": ["https://cdn.example.com/scene.mp4"]
@1 = 第一个素材(按 images 在前、videos 在后的顺序编号)
参数说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | ✅ | SD-2.0-Fast-720P 或 SD-2.0-Pro-720P |
prompt | string | ✅ | ≤1500字符,支持 @引用 |
duration | int | ❌ | 5~15秒 |
images | string[] | ❌ | 参考图 URL,最多4张 |
videos | string[] | ❌ | 参考视频 URL,最多3个 |
限制
| 项目 | 限制 |
|---|---|
| 参考图片 | 最多 4 张 |
| 参考视频 | 最多 3 个 |
| Prompt 长度 | ≤ 1500 字符 |
| 素材总大小 | ≤ 20MB(所有图片+视频合计) |
| 音频 | 不直接支持,可将音频封装为 MP4 视频传入 |
💡 渠道版按条计费,提交即扣费。生成通常需要 30~120 秒。
视频 Sora 2
🎬 Sora 2 支持文生视频和图生视频,固定 12 秒时长,按次计费 ¥0.9/次。提交后异步轮询获取结果。
调用流程
Sora 2 采用异步任务模式:提交任务 → 轮询状态 → 获取视频
Step 1 · 提交任务
端点:POST /v1/videos
curl -X POST https://artifex.help/v1/videos \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "sora-2", "prompt": "a golden retriever puppy running through a field of sunflowers, slow motion, sunny afternoon", "aspect_ratio": "16:9", "duration": 12 }'
立即返回:
{
"id": "v_8c7e4b...",
"task_id": "v_8c7e4b...",
"object": "video",
"status": "queued",
"progress": 0,
"video_url": null,
"model": "sora-2"
}
Step 2 · 轮询状态
端点:GET /v1/videos/{id}
curl https://artifex.help/v1/videos/v_8c7e4b... \
-H "Authorization: Bearer YOUR_API_KEY"
完成响应:
{
"id": "v_8c7e4b...",
"object": "video",
"status": "completed",
"progress": 100,
"video_url": "https://...generated.mp4",
"completed_at": 1714200180,
"aspect_ratio": "16:9",
"duration": 12
}
状态说明
| status | 含义 | 该做什么 |
|---|---|---|
queued | 排队中 | 继续轮询 |
in_progress | 生成中(progress 0–99) | 继续轮询 |
completed | 完成 | 取 video_url(mp4 直链) |
failed | 失败 | 查看 error.message |
图生视频示例
通过 image 字段传入图片 URL 作为首帧参考:
curl -X POST https://artifex.help/v1/videos \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "sora-2", "prompt": "the character in the photo turns slowly toward the camera and smiles, soft cinematic lighting", "duration": 12, "aspect_ratio": "9:16", "image": "https://your-cdn.com/portrait.jpg" }'
Python 示例
import requests, time BASE = "https://artifex.help" KEY = "YOUR_API_KEY" headers = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"} # Step 1: 提交 res = requests.post(f"{BASE}/v1/videos", headers=headers, json={ "model": "sora-2", "prompt": "a cat wearing an astronaut helmet floating in space", "aspect_ratio": "16:9", "duration": 12 }).json() task_id = res["id"] print(f"Task submitted: {task_id}") # Step 2: 轮询 while True: time.sleep(10) status = requests.get(f"{BASE}/v1/videos/{task_id}", headers=headers).json() print(f"Status: {status['status']} Progress: {status.get('progress', 0)}%") if status["status"] == "completed": print("Video URL:", status["video_url"]) break elif status["status"] == "failed": print("Failed:", status.get("error")) break
提交字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | ✅ | sora-2 |
prompt | string | ✅* | prompt 或 image 至少一项 |
aspect_ratio | string | ❌ | 16:9 / 9:16,默认 16:9 |
duration | int | ❌ | 固定 12 秒 |
image | string | array | ❌ | 图片 URL(首帧参考) |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id / task_id | string | 任务 ID(双字段兼容) |
status | string | queued / in_progress / completed / failed |
progress | int | 0–100 |
video_url | string | null | 完成时为 mp4 直链 |
completed_at | int | 完成时间戳 |
error | object | 失败时返回 {message, code} |
💡 Sora 2 按次计费 ¥0.9/次,提交即扣费。生成通常需要 60~180 秒。
错误码
| HTTP 状态码 | 错误类型 | 说明 |
|---|---|---|
| 401 | Unauthorized | API Key 无效或未传 |
| 402 | Payment Required | 账户余额不足,请充值 |
| 429 | Too Many Requests | 请求频率超出限制,稍后重试 |
| 500 | Server Error | 服务器内部错误,请稍后重试 |
| 503 | Service Unavailable | 上游服务暂时不可用 |
错误响应格式
{
"error": {
"message": "Incorrect API key provided",
"type": "invalid_request_error",
"code": "invalid_api_key"
}
}
Artifex API · artifex.help