Artifex API 文档
兼容 OpenAI 格式 · 高速稳定 · 支持 GPT-5 / Grok / 图像生成
Base URL
https://artifex.help
✅ 完全兼容 OpenAI SDK,只需将
base_url 改为 https://artifex.help/v1 即可无缝接入,无需修改其他代码。Python 示例
🐍 Python · openai SDK
from openai import OpenAI client = OpenAI( api_key="sk-your-api-key", base_url="https://artifex.help/v1", ) response = client.chat.completions.create( model="gpt-5.5", messages=[{"role": "user", "content": "你好"}] ) print(response.choices[0].message.content)
JavaScript 示例
🟨 JavaScript · Node.js
import OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-your-api-key", baseURL: "https://artifex.help/v1", }); const res = await client.chat.completions.create({ model: "gpt-5.5", messages: [{ role: "user", content: "你好" }], }); console.log(res.choices[0].message.content);
cURL 示例
🖥️ cURL
curl https://artifex.help/v1/chat/completions \ -H "Authorization: Bearer sk-your-api-key" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.5", "messages": [{"role": "user", "content": "你好"}] }'
鉴权方式
所有请求需在 HTTP Header 中携带 API Key:
Bearer Token 鉴权
所有接口通用
Authorization: Bearer sk-your-api-key
⚠️ API Key 请妥善保管,不要在前端代码或公开仓库中明文存储。
模型与定价
所有价格单位为美元(USD)。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 GPT-5 系列
基于 OpenAI GPT-5 架构,支持长上下文、函数调用、流式输出。支持 Prompt Cache,重复上下文可节省约 50% 费用。
POST
/v1/chat/completions
发送对话请求
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 必填 | gpt-5.5 / gpt-5.4 / gpt-5.4-mini |
| messages | array | 必填 | 对话历史,每项含 role(system/user/assistant)和 content |
| stream | boolean | 可选 | 是否流式输出,默认 false |
| temperature | number | 可选 | 生成随机性 0~2,默认 1 |
| max_tokens | integer | 可选 | 最大输出 token 数 |
| tools | array | 可选 | Function Calling 工具定义 |
请求示例
🌐 HTTP
POST /v1/chat/completions
Authorization: Bearer sk-your-api-key
Content-Type: application/json
{
"model": "gpt-5.5",
"messages": [
{ "role": "system", "content": "你是专业助手" },
{ "role": "user", "content": "帮我分析市场趋势" }
]
}
响应示例
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"model": "gpt-5.5",
"choices": [{
"index": 0,
"message": { "role": "assistant", "content": "..." },
"finish_reason": "stop"
}],
"usage": {
"prompt_tokens": 30,
"completion_tokens": 256,
"prompt_tokens_details": { "cached_tokens": 0 },
"total_tokens": 286
}
}
POST
/v1/chat/completions
流式输出 stream: true
将
"stream": true 加入请求体,响应以 text/event-stream 格式逐块返回,适合实时打字机效果展示。🐍 Python · 流式
with client.chat.completions.stream( model="gpt-5.5", messages=[{"role": "user", "content": "写一首诗"}], ) as stream: for text in stream.text_stream: print(text, end="", flush=True)
Grok Grok 系列
grok-4.20-0309-non-reasoning 由 xAI 提供,具备实时访问 X(Twitter)数据的能力,适合需要最新资讯的场景。接口格式与 GPT 完全一致,每次请求固定 $0.10。
POST
/v1/chat/completions
grok-4.20-0309-non-reasoning
请求示例
🌐 HTTP
POST /v1/chat/completions
Authorization: Bearer sk-your-api-key
Content-Type: application/json
{
"model": "grok-4.20-0309-non-reasoning",
"messages": [
{ "role": "user", "content": "今天 X 上有哪些科技热点?" }
]
}
响应示例
{
"id": "chatcmpl-xyz",
"model": "grok-4.20-0309-non-reasoning",
"choices": [{
"message": {
"role": "assistant",
"content": "根据 X 上的最新讨论..."
},
"finish_reason": "stop"
}]
}
图像 GPT Image 系列
使用 gpt-image-2-all 模型,支持文字生图、图片编辑、多图合并,每次请求固定 $0.10,同步返回图片 URL。
POST
/v1/images/generations
文字生图
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 必填 | gpt-image-2-all |
| prompt | string | 必填 | 图像描述,支持中英文 |
| size | string | 可选 | 1024x1024(默认)· 1536x1024(横版)· 1024x1536(竖版) |
| n | integer | 可选 | 生成数量,默认 1 |
| image | array[string] | 可选 | 传入则切换为图片编辑模式,最多 5 张图片 URL |
文字生图示例
🌐 HTTP
POST /v1/images/generations
Authorization: Bearer sk-your-api-key
Content-Type: application/json
{
"model": "gpt-image-2-all",
"prompt": "一只在星空下奔跑的金色猎豹,超写实风格",
"size": "1024x1024"
}
图片编辑 / 多图合并示例
🌐 HTTP
POST /v1/images/generations
Authorization: Bearer sk-your-api-key
Content-Type: application/json
{
"model": "gpt-image-2-all",
"prompt": "将这两张图中的人物合并在同一背景下",
"image": [
"https://example.com/photo1.jpg",
"https://example.com/photo2.jpg"
]
}
响应示例
{
"created": 1746000000,
"data": [{
"url": "https://...",
"revised_prompt": "..."
}]
}
✅ 图像接口同步返回,无需轮询。参考图片 URL 需可公开访问。
视频 Seedance 视频生成
⚠️ 视频模型仅限 VIP 分组用户使用,请确认您的账号已开通 VIP 权限。
基于火山引擎 Seedance 2.0,支持文字生视频。采用异步任务模式:先提交任务获取 task_id,再轮询查询结果。
可用模型
| 模型 | 720p 价格 | 1080p 价格 | 说明 |
|---|---|---|---|
| 火山-seedance2.0-fast | ¥0.60 / 秒 | ¥0.75 / 秒 | 快速生成,适合预览 |
| 火山-seedance2.0 | ¥0.75 / 秒 | ¥0.90 / 秒 | 标准品质 |
分辨率与 size 参数对照
| size | 分辨率 | 比例 |
|---|---|---|
| 1280x720 | 720p | 16:9 横版(默认) |
| 720x1280 | 720p | 9:16 竖版 |
| 1024x1024 | 720p | 1:1 方形 |
| 1792x1024 | 1080p | 16:9 横版 |
| 1024x1792 | 1080p | 9:16 竖版 |
POST
/v1/videos
第一步:提交任务
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 必填 | 火山-seedance2.0-fast 或 火山-seedance2.0 |
| prompt | string | 必填 | 视频内容描述,支持中英文 |
| size | string | 可选 | 分辨率,见上表,默认 1280x720 |
| seconds | number | 可选 | 视频时长(秒),默认 5 |
🌐 HTTP · 提交任务
POST /v1/videos
Authorization: Bearer sk-your-api-key
Content-Type: application/json
{
"model": "火山-seedance2.0-fast",
"prompt": "一只猫在阳光下的草地上奔跑,慢镜头,电影感",
"size": "1280x720",
"seconds": 5
}
提交响应
{
"id": "task_abc123",
"object": "video",
"model": "火山-seedance2.0-fast",
"status": "queued",
"progress": 0,
"created_at": 1746000000,
"seconds": "5",
"size": "1280x720"
}
GET
/v1/videos/:task_id
第二步:查询状态
用第一步返回的 id 轮询此接口,建议间隔 5 秒,直到 status 为 completed 或 failed。
任务状态
| status | 含义 |
|---|---|
| queued | 已提交,等待处理 |
| in_progress | 生成中(progress 0~99) |
| completed | 完成,result_urls 中包含视频链接 |
| failed | 失败,见 error 字段 |
完成时响应
{
"id": "task_abc123",
"object": "video",
"model": "火山-seedance2.0-fast",
"status": "completed",
"progress": 100,
"created_at": 1746000000,
"completed_at": 1746000090,
"seconds": "5",
"size": "1280x720",
"result_urls": ["https://cdn.example.com/video-abc123.mp4"]
}
Python 完整示例
🐍 Python
import requests, time BASE = "https://artifex.help" KEY = "sk-your-api-key" H = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"} # 第一步:提交 r = requests.post(f"{BASE}/v1/videos", headers=H, json={ "model": "火山-seedance2.0-fast", "prompt": "一只猫在阳光下奔跑", "size": "1280x720", "seconds": 5, }) task_id = r.json()["id"] # 第二步:轮询 for _ in range(60): time.sleep(5) res = requests.get(f"{BASE}/v1/videos/{task_id}", headers=H).json() print(f"status={res['status']} progress={res.get('progress',0)}%") if res["status"] == "completed": print("video:", res["result_urls"][0]) break if res["status"] == "failed": print("failed:", res.get("error")) break
💡 视频生成通常需要 30~120 秒。费用在提交时预扣,完成后按实际秒数结算。
错误码
| 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