Documentation

Dokumentasi integrasi

666 AI mendukung tiga protokol yang umum dipakai. Alat yang sudah Anda gunakan hampir pasti bisa langsung tersambung: ganti satu alamat, tempelkan satu API Key, sisanya biarkan.

Pada contoh di bawah, ganti YOUR-ENDPOINT dengan alamat Anda sendiri — alamat itu tampil di halaman depan konsol, atau biarkan panduan awal membuatkan konfigurasinya untuk Anda.

Sambungkan dalam tiga langkah

Dari mendaftar sampai permintaan pertama berhasil biasanya tidak sampai tiga menit.

1. Ambil API Key Anda

Buat satu di halaman «API Key» pada konsol. Sebaiknya satu kunci untuk satu proyek, lengkap dengan batas pemakaian.

2. Isi alamatnya

BASE URL

https://YOUR-ENDPOINT/v1

3. Coba dulu

curl

curl https://YOUR-ENDPOINT/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash",
       "messages":[{"role":"user","content":"hi"}]}'

# A JSON response means it works

Protokol yang didukung

Satu API Key, satu saldo, tiga protokol yang bisa dipilih. Anda tidak perlu menyiapkan kunci berbeda untuk tiap alat.

Tersedia

OpenAI

Yang paling umum. Hampir semua alat dan SDK mendukungnya secara bawaan.

/v1/chat/completions

Tersedia

Anthropic

Format asli Claude Code dan Cline, tanpa lapisan penyesuaian.

/v1/messages

Sedang disiapkan

Gemini

Format asli Google, cocok untuk proyek yang sudah ditulis untuk Gemini.

/v1beta/models

Bingung memilih? Pakai format OpenAI: kompatibilitasnya paling luas, dan berganti model tidak menuntut perubahan kode.

Format OpenAI

Pustaka resmi openai bisa langsung dipakai; yang berubah hanya base_url.

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_KEY",
    base_url="https://YOUR-ENDPOINT/v1"
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_KEY",
  baseURL: "https://YOUR-ENDPOINT/v1"
});

const resp = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "你好" }]
});
console.log(resp.choices[0].message.content);

Format Anthropic

Kalau Anda memakai Claude Code atau SDK resmi Anthropic, pilih format ini, tanpa perlu lapisan konversi. Perhatikan: alamat ini tidak memakai /v1.

Claude Code

# Add to ~/.zshrc or ~/.bashrc
export ANTHROPIC_BASE_URL="https://YOUR-ENDPOINT"
export ANTHROPIC_AUTH_TOKEN="YOUR_KEY"

# Reopen the terminal, then just run
claude

Python SDK

from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_KEY",
    base_url="https://YOUR-ENDPOINT"
)

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

Format Gemini

Sedang disiapkan. Sementara itu, model Gemini tetap bisa dipanggil lewat format OpenAI di atas, dengan fungsi yang sama.

curl

# Call Gemini like this
curl https://YOUR-ENDPOINT/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.5-flash","messages":[{"role":"user","content":"hi"}]}'

Editor dan agen

Cursor

Settings → Models → OpenAI API Key
Aktifkan Override Base URL
Isi alamat dan API Key, lalu klik Verify

Claude Code

Atur ANTHROPIC_BASE_URL
Atur ANTHROPIC_AUTH_TOKEN
Buka ulang terminal lalu jalankan claude

Cline / Roo Code

Pilih OpenAI Compatible sebagai Provider
Isi Base URL dan API Key
Isi Model ID dengan ID dari katalog

Continue

Sunting config.json
Isi provider dengan openai
Tambahkan kolom apiBase

Aplikasi dan ekstensi

ChatBox / NextChat

Pilih OpenAI sebagai layanan model
Isi domain API dengan alamat gateway
Ketik nama modelnya secara manual

Immersive Translate

Tambahkan antarmuka AI kustom
Alamat: /v1/chat/completions
Sebaiknya pilih model yang cepat dan murah

Open WebUI

Pengaturan → Koneksi eksternal
Tambahkan koneksi OpenAI API
Isi alamat dan API Key, lalu simpan

Framework pengembangan

Dify

Pilih OpenAI-API-compatible sebagai penyedia model
Isi API endpoint dan API Key
Pengaturan node lainnya tidak berubah

n8n

Buat kredensial OpenAI baru
Isi Base URL dengan alamat gateway
Pilih kredensial itu di dalam node

LangChain

Gunakan ChatOpenAI
Berikan base_url
Rantai selebihnya tidak berubah

Streaming / Pemanggilan tools / Visi

Ketiganya dipakai persis seperti pada antarmuka resmi, parameternya tidak perlu diubah. Dukungannya bergantung pada modelnya dan sudah ditandai di katalog.

Keluaran streaming

stream = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role":"user","content":"写一首诗"}],
    stream=True
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

Cache prompt

Kalau setiap permintaan membawa awalan panjang yang sama — prompt sistem, kode proyek, dokumen — bagian yang tersimpan di cache ditagih dengan potongan besar. Paling terasa pada pekerjaan koding dan agen.

Taruh bagian yang tetap di depan, bagian yang berubah di belakang. Urutannya yang menentukan seberapa sering cache kena.

Kode kesalahan

Kode	Artinya	Yang perlu dilakukan
`401`	API Key tidak berlaku atau sudah dinonaktifkan	Periksa apakah API Key tersalin utuh dan belum terhapus
`402`	Saldo tidak cukup	Isi saldo lewat konsol
`404`	Model tidak ditemukan	Cocokkan ejaan ID-nya dengan katalog model
`429`	Permintaan terlalu sering	Kurangi jumlah permintaan bersamaan, atau coba lagi nanti
`500`	Gangguan di sisi penyedia	Gateway otomatis mencoba jalur cadangan. Hubungi kami bila kesalahannya terus muncul

Kuota dan batas

Setiap API Key bisa diberi batas pemakaian dan daftar model sendiri. Gunakan satu kunci per proyek: bila ada yang bocor, kerugiannya terbatas dan Anda cukup menghapus lalu membuat yang baru.

Permintaan yang gagal tidak ditagih. Timeout dan kesalahan penyedia tidak masuk ke tagihan Anda.