Hướng dẫn kết nối

Antigravity (Google)

Phương án 1 — Antigravity CLI (khuyến nghị)

1. Tạo file cấu hình:

   mkdir -p ~/.gemini/antigravity-cli
   
   cat > ~/.gemini/antigravity-cli/settings.json <<'EOF'
   {
     "modelProvider": "gemini"
   }
   EOF

   Windows: %USERPROFILE%\.gemini\antigravity-cli\settings.json
2. Xuất biến môi trường:

   export GEMINI_API_KEY="sk-duan-xxxxxxxx"
   export GOOGLE_GEMINI_BASE_URL="https://thuehay.com"
   export GEMINI_API_KEY_AUTH_MECHANISM=bearer

   Đặt base URL là origin trần, KHÔNG có /v1 hay /v1beta — CLI tự thêm /v1beta vào sau. Nếu thêm /v1beta bạn sẽ gặp lỗi 404.
   Biến GEMINI_API_KEY_AUTH_MECHANISM=bearer buộc CLI gửi key dạng Authorization: Bearer thay vì x-goog-api-key (mặc định) — hệ thống hỗ trợ cả hai.
3. Chạy thử:

   agy --model gemini-2.5-flash --effort low

   Khi dùng model Gemini, nhớ thêm --effort (low / medium / high).

Phương án 2 — Kiểm tra kết nối bằng curl

Luôn kiểm tra bằng curl trước khi cấu hình IDE/CLI — phần lớn lỗi "API problem" chỉ là do sai tên model hoặc sai định dạng request.

curl -X POST "https://thuehay.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "Authorization: Bearer sk-duan-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      { "role": "user", "parts": [{ "text": "Reply with exactly: ok" }] }
    ]
  }'

Phương án 3 — Antigravity SDK (Python)

import asyncio
from google.antigravity import Agent, LocalOpenAIAgentConfig

async def main():
    config = LocalOpenAIAgentConfig(
        model="gpt-4o-mini",
        base_url="https://thuehay.com/v1",
        api_key="sk-duan-xxxxxxxx",
    )
    async with Agent(config) as agent:
        response = await agent.chat("Xin chào!")
        async for token in response:
            print(token, end="", flush=True)

asyncio.run(main())

VS Code

Dùng extension Continue, Cline, Roo Code hoặc GitHub Copilot Chat (BYO key).

Continue

{
  "models": [
    {
      "title": "DuanAPI GPT-4o Mini",
      "provider": "openai",
      "model": "gpt-4o-mini",
      "apiBase": "https://thuehay.com/v1",
      "apiKey": "sk-duan-xxxxxxxx"
    }
  ]
}

Cline / Roo Code

1. Mở panel extension (biểu tượng Cline ở thanh bên phải).
2. Bấm biểu tượng ⚙️ bánh răng (API Provider) → chọn OpenAI Compatible.
3. Điền:
   • Base URL: https://thuehay.com/v1
   • API Key: sk-duan-xxxxxxxx
   • Model ID: gpt-4o-mini
4. Lưu và bắt đầu chat.

Cherry Studio / LM Studio / AnythingLLM / LobeChat

Ở mọi app này, chọn provider OpenAI / OpenAI Compatible rồi điền Base URL + API key như trên.

Windsurf

1. Mở Windsurf Settings → tab API Keys (biểu tượng chìa khóa).
2. Chọn provider OpenAI Compatible hoặc mục Add custom provider.
3. Điền Base URL https://thuehay.com/v1, API key sk-duan-... và tên model.
4. Lưu → chọn model trong dropdown chat.

Cline / Roo Code / Continue

Cả ba đều dùng cấu hình OpenAI-compatible giống nhau.

Base URL:   https://thuehay.com/v1API Key:    sk-duan-xxxxxxxx
Model ID:   gpt-4o-mini

• Chọn provider OpenAI Compatible (không phải "OpenAI" — provider OpenAI gốc sẽ ép base URL).
• Bật Use custom base URL nếu app có tùy chọn này.
• Tắt Use custom context window / max tokens nếu app hỏi — để app tự suy ra.

CLI & SDK

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="sk-duan-xxxxxxxx",
    base_url="https://thuehay.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Viết haiku về AI"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-duan-xxxxxxxx",
  baseURL: "https://thuehay.com/v1",
});

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

cURL

curl "https://thuehay.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-duan-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Xin chào"}]
  }'

Anthropic SDK

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-duan-xxxxxxxx",
    base_url="https://thuehay.com/v1",
)

msg = client.messages.create(
    model="claude-3-5-sonnet",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Xin chào"}],
)
print(msg.content[0].text)

Gemini SDK

from google import genai

client = genai.Client(
    api_key="sk-duan-xxxxxxxx",
    http_options={"base_url": "https://thuehay.com"},
)

resp = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="Xin chào",
)
print(resp.text)