شروع کار

شروع سریع

در چند دقیقه کلید API بسازید و اولین درخواست چت را با cURL، Python یا Node بفرستید.

۱. ساخت کلید

به /app/developer بروید، بخش کلیدها را باز کنید و یک کلید بسازید. کلید کامل (sk-1ai- و ۴۰ نویسه) فقط یک بار نشان داده می‌شود. آن را در متغیر محیطی نگه دارید، نه در کد.

bash
export ONEAI_API_KEY="sk-1ai-..."

برای شروع باید در حساب اعتبار داشته باشید. اگر اعتبار کافی نباشد، درخواست با کد insufficient_credits و وضعیت 402 رد می‌شود. اعتبار را ببینید.

۲. اولین درخواست

bash
curl https://1ai.ir/v1/chat/completions \
  -H "Authorization: Bearer $ONEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-luna",
    "messages": [{"role": "user", "content": "Say hello in one short sentence."}]
  }'
python
# pip install openai
import os
from openai import OpenAI

client = OpenAI(base_url="https://1ai.ir/v1", api_key=os.environ["ONEAI_API_KEY"])

reply = client.chat.completions.create(
    model="openai/gpt-6-luna",
    messages=[{"role": "user", "content": "Say hello in one short sentence."}],
)
print(reply.choices[0].message.content)
javascript
// npm install openai
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://1ai.ir/v1", apiKey: process.env.ONEAI_API_KEY });

const reply = await client.chat.completions.create({
  model: "openai/gpt-6-luna",
  messages: [{ role: "user", content: "Say hello in one short sentence." }],
});
console.log(reply.choices[0].message.content);

پاسخ، بدنه‌ی استاندارد chat.completion است. سرآیند x-1ai-credits مقدار اعتبار کم‌شده را می‌گوید و x-request-id شناسه‌ی درخواست برای پیگیری است.

۳. انتخاب مدل

شناسه‌های معتبر را از GET /v1/models بگیرید. خروجی فقط مدل‌هایی را دارد که کلید شما اجازه‌ی استفاده از آن‌ها را دارد و قیمتشان تعیین شده است.

bash
curl "https://1ai.ir/v1/models?kind=chat" \
  -H "Authorization: Bearer $ONEAI_API_KEY"

قدم بعدی

  • پاسخ را تکه‌تکه بگیرید: استریم.
  • بدانید چه چیزی خطا می‌دهد و کدام را دوباره بفرستید: خطاها.
  • سقف درخواست را بشناسید: محدودیت نرخ.
  • با کتابخانه‌ی Anthropic یا Gemini کار می‌کنید؟ Messages و Gemini را ببینید.

صفحه‌های مرتبط