HƯỚNG DẪN BẮT ĐẦU

Getting Started

3 bước nhanh chóng để tích hợp và bắt đầu sử dụng Kandes AI API.

1Bước 1 — Mua Gói Dịch Vụ

Vào kandes.shop/products để mua gói AI phù hợp. Sau khi thanh toán hoàn tất, bạn sẽ nhận được chuỗi API key ks-xxx gửi trực tiếp qua email.

2Bước 2 — Cấu Hình Biến Môi Trường (Environment)

Thiết lập Base URL và API Key cho công cụ client bạn đang sử dụng:

1. Claude Code

export ANTHROPIC_BASE_URL="https://api.kandes.shop/v1"
export ANTHROPIC_AUTH_TOKEN="ks-YOUR_KEY_HERE"

2. Codex CLI / OpenAI Client

export OPENAI_BASE_URL="https://api.kandes.shop/v1"
export OPENAI_API_KEY="ks-YOUR_KEY_HERE"

3. Python (openai SDK)

import openai

client = openai.OpenAI(
    base_url="https://api.kandes.shop/v1",
    api_key="ks-YOUR_KEY_HERE",
)

# Có thể dùng alias kandes-* hoặc raw model name
resp = client.chat.completions.create(
    model="kandes-claude",
    messages=[{"role": "user", "content": "Xin chào"}],
)
print(resp.choices[0].message.content)

4. Node.js

import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://api.kandes.shop/v1',
  apiKey: 'ks-YOUR_KEY_HERE',
})

const resp = await client.chat.completions.create({
  model: 'kandes-claude',
  messages: [{ role: 'user', content: 'Xin chào' }],
})
console.log(resp.choices[0].message.content)

3Bước 3 — Kiểm Tra Kết Nối (Test)

curl — Chat Completions API

curl -X POST https://api.kandes.shop/v1/chat/completions \
  -H "Authorization: Bearer ks-YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kandes-claude",
    "messages": [{"role": "user", "content": "Xin chào"}]
  }'

curl — Responses API (Codex)

curl -X POST https://api.kandes.shop/v1/responses \
  -H "Authorization: Bearer ks-YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": [{"role": "user", "content": "hello"}]
  }'