شروع کار
شروع سریع
در چند دقیقه کلید 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 را ببینید.
صفحههای مرتبط
- احراز هویتکلید API را چگونه بفرستید، قالب آن چیست، چه چیزی باعث رد شدن کلید میشود و چطور آن را امن نگه دارید.
- استریمقالب SSE در چت، پایان استریم، قطعهی usage با مقدار اعتبار، خطای میانهی راه و رفتار هنگام قطع شدن اتصال.
- خطاهاقالب دقیق خطا در /v1، فهرست وضعیتها و کدها و اینکه کدام خطا را باید دوباره فرستاد.
- تکمیل گفتگوپاسخ یک مدل گفتگو را به قالب OpenAI میگیرید: متن ساده، استریم، فراخوانی ابزار و ورودی تصویر، با همان SDK رسمی OpenAI.