Gọi API Claude bằng Python và Node.js với key RocketKey

Key RocketKey không chỉ dùng cho Claude Code hay Cursor: bạn gọi được API từ code của mình bằng Anthropic SDK (API Messages) hoặc OpenAI SDK (API Chat Completions). Chỉ cần đổi hai thứ: base URL trỏ về RocketKey và API key là key RocketKey của bạn. Mọi request trừ vào cùng hạn mức USD mỗi ngày của gói.

Chưa có key? Đọc Bắt đầu trước.

1. Đặt key vào biến môi trường

Đừng ghi key thẳng vào code. Các ví dụ dưới đây đọc key từ biến ROCKETKEY_API_KEY:

export ROCKETKEY_API_KEY='sk-rk-YOUR_KEY_HERE'

$env:ROCKETKEY_API_KEY = 'sk-rk-YOUR_KEY_HERE'

set ROCKETKEY_API_KEY=sk-rk-YOUR_KEY_HERE

Biến chỉ có hiệu lực trong cửa sổ terminal đó. Trong dự án thật, bạn có thể để biến trong file .env (nhớ thêm .env vào .gitignore).

2. Anthropic SDK (khuyên dùng cho model Claude)

Cài thư viện: pip install anthropic cho Python, npm install @anthropic-ai/sdk cho Node.js. Base URL của Anthropic SDK không có /v1 ở cuối: SDK tự thêm /v1/messages.

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["ROCKETKEY_API_KEY"],
    base_url="https://rocketkeyapi.indexes.social",
)

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.ROCKETKEY_API_KEY,
  baseURL: "https://rocketkeyapi.indexes.social",
});

const message = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello" }],
});
for (const block of message.content) {
  if (block.type === "text") console.log(block.text);
}

Một số model Claude luôn suy luận trước khi trả lời, nên message.content có thể bắt đầu bằng một khối thinking. Vì vậy đoạn mã chỉ in các khối text.

Dùng Anthropic SDK khi bạn cần đủ tính năng của Claude: tool use, đọc ảnh, streaming, prompt caching. Tài liệu đầy đủ của SDK có ở platform.claude.com.

3. OpenAI SDK (khi code có sẵn dùng OpenAI)

RocketKey cũng nhận định dạng OpenAI Chat Completions, nên code đang dùng thư viện openai chỉ cần đổi base URL và model. Cài: pip install openai hoặc npm install openai. Với OpenAI SDK, base URL có /v1.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ROCKETKEY_API_KEY"],
    base_url="https://rocketkeyapi.indexes.social/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.ROCKETKEY_API_KEY,
  baseURL: "https://rocketkeyapi.indexes.social/v1",
});

const response = await client.chat.completions.create({
  model: "claude-sonnet-5-5",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(response.choices[0].message.content);

4. Chọn model

Thay claude-sonnet-5-5 bằng model ID bạn muốn, lấy từ trang Model. Sonnet là lựa chọn cân bằng cho hầu hết việc; Haiku rẻ hơn nhiều cho tác vụ đơn giản, chạy hàng loạt. Xem Chọn model Claude cho lập trình để so sánh chi phí. Model ID sai gây lỗi 404.

Lấy danh sách model mà key của bạn dùng được (không tốn hạn mức):

curl "https://rocketkeyapi.indexes.social/v1/models" \
  -H "Authorization: Bearer sk-rk-YOUR_KEY_HERE"

curl.exe "https://rocketkeyapi.indexes.social/v1/models" -H "Authorization: Bearer sk-rk-YOUR_KEY_HERE"

5. Xử lý lỗi

Theo tài liệu của Anthropic, Python SDK mặc định tự thử lại 2 lần với lỗi kết nối, 429 và lỗi 5xx, có giãn cách tăng dần. Đổi số lần bằng tham số max_retries khi tạo client. Với lỗi 402, thử lại không có tác dụng cho tới khi hạn mức reset.

Mẹo khi chạy hàng loạt

• Chi phí tính theo token input và output với giá trên trang Model. Theo dõi theo từng key ở Dashboard → Usage, mục Theo key.
• Tạo một key riêng cho mỗi ứng dụng hoặc môi trường (dev, CI). Khi cần thu hồi, chỉ khoá đúng key đó. Xem Quản lý API key.
• Câu trả lời dài nên dùng streaming (stream=True trong Python) để kết nối không bị cắt giữa chừng.
• Mọi key của tài khoản dùng chung giới hạn request mỗi phút. Chạy song song nhiều tiến trình thì giới hạn số request đồng thời để tránh 429.