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-1K1K 分辨率¥0.05/ 次按次
gpt-image-2-2K2K 分辨率¥0.12/ 次按次
gpt-image-2-4K4K 分辨率¥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-BetaHKCOPP 快速 720p¥4.50/ 条按次
Seedance-2.0-Pro-BetaHKCOPP 标准 720p¥8.00/ 条按次
Seedance-2.0-Pro-Beta-1080PHKCOPP 标准 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.51M tokens最强推理,适合复杂任务
gpt-5.41M tokens性价比之选,通用能力强
gpt-5.4-mini1M 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-1K1024x1024¥0.05/ 次
gpt-image-2-2K2048x2048¥0.12/ 次
gpt-image-2-4K4096x4096¥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"

参数说明

字段类型必填说明
modelstring火山-seedance2.0火山-seedance2.0-fast
promptstring视频描述(≤1500字符)
sizestring1280x720(默认 16:9)
durationint5~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 在后的顺序编号)

参数说明

字段类型必填说明
modelstringSD-2.0-Fast-720PSD-2.0-Pro-720P
promptstring≤1500字符,支持 @引用
durationint5~15秒
imagesstring[]参考图 URL,最多4张
videosstring[]参考视频 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

提交字段

字段类型必填说明
modelstringsora-2
promptstring✅*prompt 或 image 至少一项
aspect_ratiostring16:9 / 9:16,默认 16:9
durationint固定 12
imagestring | array图片 URL(首帧参考)

响应字段

字段类型说明
id / task_idstring任务 ID(双字段兼容)
statusstringqueued / in_progress / completed / failed
progressint0–100
video_urlstring | null完成时为 mp4 直链
completed_atint完成时间戳
errorobject失败时返回 {message, code}
💡 Sora 2 按次计费 ¥0.9/次,提交即扣费。生成通常需要 60~180 秒。
错误码
HTTP 状态码错误类型说明
401UnauthorizedAPI Key 无效或未传
402Payment Required账户余额不足,请充值
429Too Many Requests请求频率超出限制,稍后重试
500Server Error服务器内部错误,请稍后重试
503Service Unavailable上游服务暂时不可用

错误响应格式

{
  "error": {
    "message": "Incorrect API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}
Artifex API · artifex.help