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 发送对话请求

请求参数

参数类型必填说明
modelstring必填gpt-5.5 / gpt-5.4 / gpt-5.4-mini
messagesarray必填对话历史,每项含 role(system/user/assistant)和 content
streamboolean可选是否流式输出,默认 false
temperaturenumber可选生成随机性 0~2,默认 1
max_tokensinteger可选最大输出 token 数
toolsarray可选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 文字生图

请求参数

参数类型必填说明
modelstring必填gpt-image-2-all
promptstring必填图像描述,支持中英文
sizestring可选1024x1024(默认)· 1536x1024(横版)· 1024x1536(竖版)
ninteger可选生成数量,默认 1
imagearray[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分辨率比例
1280x720720p16:9 横版(默认)
720x1280720p9:16 竖版
1024x1024720p1:1 方形
1792x10241080p16:9 横版
1024x17921080p9:16 竖版
POST /v1/videos 第一步:提交任务

请求参数

参数类型必填说明
modelstring必填火山-seedance2.0-fast火山-seedance2.0
promptstring必填视频内容描述,支持中英文
sizestring可选分辨率,见上表,默认 1280x720
secondsnumber可选视频时长(秒),默认 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 秒,直到 statuscompletedfailed

任务状态

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 状态码错误类型说明
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