📖 开发者文档

5 分钟快速接入

ArtsAPI 完全兼容 OpenAI SDK,只需更换 Base URL 和 API Key,无需修改任何业务代码。

快速接入

ArtsAPI 完全兼容 OpenAI API 格式,仅需更改两处配置:

Base URL: https://api.artsapi.com/v1
API Key: 在控制台获取您的专属密钥

Python(openai 库)

Python
from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.artsapi.com/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)
print(response.choices[0].message.content)

Node.js(openai 库)

JavaScript
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'your-api-key',
  baseURL: 'https://api.artsapi.com/v1',
});

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello!' }],
});
console.log(response.choices[0].message.content);

cURL

cURL
curl https://api.artsapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

认证方式

所有请求需在 HTTP Header 中携带 API Key:

HTTP Header
Authorization: Bearer <YOUR_API_KEY>
⚠️ 请妥善保管您的 API Key,不要将其暴露在客户端代码或公开仓库中。

流式输出

设置 stream: true 即可开启 SSE 流式响应,适合实时展示生成内容:

Python
stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "讲个故事"}],
    stream=True
)

for chunk in stream:
    delta = chunk.choices[0].delta.content or ""
    print(delta, end="", flush=True)