Permintaan pertama anda

Panduan ini membawa anda melalui panggilan API pertama anda dari awal. Sebelum bermula, pastikan:

1. Anda telah mencipta kunci API dan menyimpan kunci penuh tersebut.
2. Anda mempunyai Base URL: log masuk ke konsol, buka dialog "Mula pantas", pilih satu protokol dan salinnya. Contoh di bawah menggunakan https://<your-base-url> sebagai pemegang tempat — gantikannya dengan alamat anda sendiri.

Platform ini menyokong tiga protokol asli; pilih mana-mana yang sesuai — pengebilan dan baki adalah identik bagi kesemuanya.

Protokol serasi OpenAI (saranan lalai)

Serasi sepenuhnya dengan SDK OpenAI: halakan base_url ke platform ini dan kod sedia ada anda terus berfungsi.

cURL

curl https://<your-base-url>/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python (openai SDK)

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://<your-base-url>",
)

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

Node.js (openai SDK)

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://<your-base-url>",
})

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

Protokol Anthropic

Isomorfik dengan Anthropic Messages API: sahkan dengan x-api-key dan sertakan anthropic-version:

curl https://<your-base-url>/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Protokol Gemini

Isomorfik dengan Google GenAI API: ID model dimasukkan ke dalam laluan, dan pengesahan menggunakan x-goog-api-key:

curl "https://<your-base-url>/v1beta/models/your-model:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello"}]}]
  }'

Sahkan hasilnya

Permintaan yang berjaya akan memulangkan balasan model (bagi protokol OpenAI ia berada dalam choices[0].message.content). Daripada situ anda boleh:

• Semak penggunaan dan perubahan baki di halaman "Penggunaan" dalam konsol;
• Gantikan your-model dengan ID model sebenar daripada pasaran model (modaliti teks, imej, audio, video dan fail disokong).

Ralat biasa pada panggilan pertama

Petua produksi: simpan kunci dalam pemboleh ubah persekitaran (contohnya OPENAI_API_KEY) daripada mengodkannya secara terus, dan utamakan SDK rasmi berbanding panggilan HTTP yang ditulis sendiri — SDK menguruskan butiran keserasian protokol untuk anda.