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 需可公开访问。

错误码

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"
  }
}