快速开始

快速开始

创建一个 API Key,用 cURL、Python 或 TypeScript 发出第一个请求,并看懂响应结构。

通过 CA云上创造,一个 API Key 即可调用 Claude、GPT、Gemini、DeepSeek 等主流模型。请求按模型所属的协议发送,响应保持该协议的原始结构。

使用 CA API

  1. 1.在 控制台 创建 API Key(sk- 开头)。
  2. 2.发送第一个请求。以 Claude 为例:
bash
curl https://caapi.top/v1/messages \
  -H "x-api-key: sk-xxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "你好"}]
  }'

Python:

python
import requests

resp = requests.post(
    "https://caapi.top/v1/messages",
    headers={
        "x-api-key": "sk-xxxxxx",
        "anthropic-version": "2023-06-01",
        "content-type": "application/json",
    },
    json={
        "model": "claude-sonnet-5",
        "max_tokens": 256,
        "messages": [{"role": "user", "content": "你好"}],
    },
)
print(resp.json()["content"][0]["text"])

TypeScript:

typescript
const resp = await fetch("https://caapi.top/v1/messages", {
  method: "POST",
  headers: {
    "x-api-key": "sk-xxxxxx",
    "anthropic-version": "2023-06-01",
    "content-type": "application/json",
  },
  body: JSON.stringify({
    model: "claude-sonnet-5",
    max_tokens: 256,
    messages: [{ role: "user", content: "你好" }],
  }),
});

const data = await resp.json();
console.log(data.content[0].text);

响应示例

json
{
  "id": "msg_01KxDE...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5",
  "content": [{ "type": "text", "text": "你好!有什么可以帮你的?" }],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 9, "output_tokens": 12 }
}

回复文本在 content 数组里 typetext 的块中。字段的完整说明见 创建消息。

  • ·调用失败时返回 error 对象和顶层 trace_id,常见的是 401(API Key 无效)和 402(余额不足),对照表见 错误码。
  • ·更换模型时需同时更换协议:Claude 用 Anthropic 原生格式,GPT 用 OpenAI 兼容格式,Gemini 用 Gemini 原生格式,完整对照见 API 概览。模型 ID 以 GET /v1/models 返回为准。

使用官方 SDK

将官方 SDK 的 api_key 设为 CA API Key、base_url 指向 CA云上创造,业务代码无需修改:Anthropic SDK 用 https://caapi.top,OpenAI SDK 用 https://caapi.top/v1,Google GenAI SDK 用 https://caapi.top。各 SDK 示例见对应端点页:创建消息、创建对话补全、生成内容。

在 Agent 工具中使用

Claude Code、Codex、Cursor 等工具只需将 Base URL 与 API Key 改为 CA 的值,各工具的配置步骤见 接入指南。

后续步骤

  • ·三种协议各自的端点:API 概览
  • ·逐 token 返回生成结果:流式输出
  • ·采样参数在三种协议里的字段名:参数说明
  • ·让模型调用自定义函数:工具调用
  • ·向模型发送图片:图像输入

50 篇文档。文中出现的模型名与价格以模型广场的实时数据为准。