兴嘉来 API 开发文档

1概述

兼容 OpenAI 的 SDK / 工具通常将 base_url 设为带 /v1 的地址；Anthropic 官方 SDK 的 base_url 请使用网关根地址 https://xingjialai.net（不要带 /v1）。

平台提供 Chat Completions、Anthropic Messages、Responses、视频生成与 TTS。鉴权、智能路由、失败降级与按量计费由网关与 xjl-llm-service 统一完成。

2认证

在控制台「令牌管理」创建 API Key，请求头携带：

Authorization: Bearer {YOUR_API_KEY}

Anthropic SDK 也可使用 x-api-key。请始终在服务端调用，切勿把密钥写入前端或公开仓库。明文密钥仅在创建时返回一次。

3模型列表

cURL

curl -sS "https://xingjialai.net/v1/models" \
  -H "Authorization: Bearer sk-xxxxxxxx"

4聊天对话

cURL

curl -sS -X POST "https://xingjialai.net/v1/chat/completions" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "user", "content": "用一句话介绍上海。"}
    ],
    "temperature": 0.7,
    "stream": false
  }'

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxx",
    base_url="https://xingjialai.net/v1",
)
resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

5Anthropic Messages

SDK 的 base_url 不要带 /v1。

curl -sS -X POST "https://xingjialai.net/v1/messages" \
  -H "x-api-key: sk-xxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash-claude-proto",
    "max_tokens": 1000,
    "messages": [{"role": "user", "content": "Hi"}]
  }'

6Responses API

流式事件形态与 Chat 不同，无 data: [DONE]。

curl -sS -X POST "https://xingjialai.net/v1/responses" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "input": "Hi, how are you?",
    "stream": false
  }'

7视频生成

视频模型不可走 Chat Completions。计费按成功生成秒数 × 分辨率档位。

curl -sS "https://xingjialai.net/v1/services/aigc/video-generation/video-synthesis" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-t2v",
    "input": {"prompt": "一只猫在草地上奔跑"},
    "parameters": {"resolution": "720P", "duration": 5}
  }'

# 查询任务
curl -sS "https://xingjialai.net/v1/tasks/{task_id}" \
  -H "Authorization: Bearer sk-xxxxxxxx"

8TTS 语音

curl -sS "https://xingjialai.net/v1/services/aigc/multimodal-generation/generation" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-tts-flash",
    "input": {"text": "你好，欢迎使用兴嘉来语音合成服务"}
  }'

9错误码与限流

平台按实际错误原因返回标准 HTTP 状态码，不同类型不会统一成同一个码：

并发/QPS 超限时快速返回 429 而非长时间挂起；429/503 响应带 Retry-After 头，请按其建议退避重试。触发限流后降低请求量可自动恢复。

流式场景：长时间无数据返回时服务端发送 SSE keep-alive 注释帧；推理中途发生异常会推送标准 error 帧并结束连接；客户端主动断开后服务端及时取消上游推理并释放资源。

10常见问题