مستندات
دروازه‌ی پیکو هوش از فرمت OpenAI پیروی می‌کند؛ هر کلاینتی که با OpenAI کار می‌کند با تغییر آدرس و کلید کار خواهد کرد.
آدرس پایه https://api.picoai.ir/v1 است. یک کلید از داشبورد بگیرید و اولین درخواست را بفرستید.
curl https://api.picoai.ir/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"messages": [{"role": "user", "content": "سلام!"}]
}'کلید را در هدر Authorization: Bearer YOUR_API_KEY بفرستید. برای endpoint فرمت Anthropic هدر x-api-key هم پذیرفته می‌شود. کلید را فقط در سمت سرور نگه دارید و آن را در کد فرانت‌اند یا مخزن عمومی قرار ندهید.
| متد | مسیر | کاربرد |
|---|---|---|
| POST | /chat/completions | گفتگو و تولید متن (فرمت OpenAI، با پشتیبانی از stream) |
| POST | /messages | گفتگو با فرمت Anthropic Messages |
| GET | /models | فهرست مدل‌های در دسترس |
| POST | /embeddings | بردار معنایی متن |
| POST | /images/generations | تولید تصویر |
| POST | /videos | ساخت ویدیو (ناهمگام) |
| GET | /videos/{taskId} | پیگیری وضعیت ساخت ویدیو |
| POST | /audio/speech | تبدیل متن به گفتار |
| POST | /audio/music | تولید موسیقی |
شناسه‌ی مدل‌ها را از کاتالوگ یا از GET /models بردارید.
با "stream": true پاسخ به صورت Server-Sent Events و تکه‌تکه می‌رسد، دقیقاً مثل OpenAI.
curl https://api.picoai.ir/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-N \
-d '{
"model": "claude-sonnet-5-5",
"stream": true,
"messages": [{"role": "user", "content": "یک جمله بگو."}]
}'به‌صورت پیش‌فرض هیچ چیز در درخواست شما تغییر نمی‌کند. برای کاهش هزینه در موارد خاص، هدر x-pico-optimize را بفرستید. هزینه همیشه بر اساس توکن‌هایی حساب می‌شود که ارائه‌دهنده واقعاً گزارش می‌کند؛ پس هر توکنِ صرفه‌جویی‌شده مستقیماً از صورتحساب شما کم می‌شود.
curl https://api.picoai.ir/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "x-pico-optimize: rtk, terse=lite, history=20" \
-d '{"model":"gpt-6-sol","messages":[{"role":"user","content":"..."}]}'پاسخ شامل هدر X-Pico-Optimize است (مثلاً rtk=18342B-saved;terse=lite) تا ببینید چه چیزی اعمال شده است. این قابلیت روی /v1/chat/completions و /v1/messages کار می‌کند.