تولید ویدیو

ساخت ویدیو از متن: درخواست، وضعیت‌ها، دانلود و قیمت هر ثانیه.

مدل‌های ویدیویی در دسترس

720p, no sound

‎$ 0.672 / ثانیه

1080p, no sound

‎$ 0.896 / ثانیه

720p, with sound

‎$ 1.008 / ثانیه

1080p, with sound

‎$ 1.344 / ثانیه

720p, sound included

‎$ 0.896 / ثانیه

1080p, sound included

‎$ 1.12 / ثانیه

روند کار

1. POST /v1/videos/generations را با مدل، یک پرامپت و گزینه‌ها بفرستید. پاسخ یک request_id دارد.
2. ویدیوها ناهمگام ساخته می‌شوند، معمولاً در 1 تا 3 دقیقه. وضعیت را هر 10 ثانیه بررسی کنید تا done یا failed شود.
3. وقتی وضعیت done شد، فایل را از مسیر داخل video.url با همان کلید دانلود کنید.

درخواست

curl -sS https://api.oneprovider.dev/v1/videos/generations \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-3.0",
"prompt": "A red balloon rises over a quiet harbor at sunrise",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
# {"request_id":"task_..."}

ترکیبی که در جدول قیمت نباشد فوراً با خطای 400 رد می‌شود و چیزی کسر نمی‌شود.

وضعیت

curl -sS https://api.oneprovider.dev/v1/videos/generations/$REQUEST_ID \
-H "Authorization: Bearer $ONEPROVIDER_KEY"
# {"request_id":"task_...","status":"pending","progress":50}
# {"request_id":"task_...","status":"done","progress":100,
# "video":{"url":"/v1/videos/generations/$REQUEST_ID/content","duration":5}}

دانلود

curl -sS https://api.oneprovider.dev/v1/videos/generations/$REQUEST_ID/content \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-o video.mp4

پاسخ یک فایل video/mp4 است و هدر Range پشتیبانی می‌شود. فایل را همان لحظه سمت خودتان ذخیره کنید؛ روی کار کردن همیشگی پیوند حساب نکنید.

قیمت‌ها

هزینه بر اساس هر ثانیه ویدیو و با نرخ ردیف مربوط در جدول بالا (وضوح و صدا) کسر می‌شود. کسر یک بار انجام می‌شود، وقتی وضعیت done شود؛ برای ویدیوی ناموفق یا ناتمام چیزی کسر نمی‌شود.

مثال: kling-3.0، 720p، بدون صدا، 5 ثانیه = ‎$ 0.672 × 5 = ‎$ 3.36.

خطاها

پاسخ‌های سریع

از کدام base URL استفاده کنم؟

Claude Code و SDKهای Anthropic از https://api.oneprovider.dev استفاده می‌کنند. SDKهای OpenAI و کلاینت‌های سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده می‌کنند. یک کلید پشت هر دو آدرس کار می‌کند؛ فهرست مدل‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است.

چگونه احراز هویت کنم؟

کلید خام sk-… را در x-api-key یا Authorization: Bearer بفرستید: یکی از این دو، نه هر دو. کلید را در یک متغیر محیطی نگه دارید، نه در فایلی که commit می‌شود. اطلاعات بیشتر دربارهٔ احراز هویت .

کلید را از کجا بگیرم؟

حساب کاربری خود را در ربات Telegram به نام @oneprovider_robot یا در app.oneprovider.dev باز کنید، موجودی را شارژ کنید و «صدور کلید» را بزنید. هر کلید می‌تواند سقف مصرف مخصوص خودش را داشته باشد. حساب کاربری و کلیدهای API .

کدهای 401، 404 و 429 یعنی چه؟

401: کلید ارسال نشده، اشتباه تایپ شده یا در هدر نادرست فرستاده شده است؛ کلید را کامل و بدون گیومه و فاصله جای‌گذاری کنید. 404: معمولاً base URL نادرست است، مثلاً /v1 جا افتاده یا دوبار آمده است. 429 با پیام «Insufficient balance»: موجودی حساب کاربری یا سقف مصرف کلید تمام شده است؛ به‌جای تلاش دوباره، شارژ کنید. هر 429 دیگری محدودیت نرخ است؛ تا پایان زمان Retry-After صبر کنید. جزئیات: کدهای خطا و رفع اشکال .

چرا استریم‌ها قطع یا ریست می‌شوند؟

VPN و پروکسی‌های VLESS اغلب SSE را بافر می‌کنند یا مذاکرهٔ HTTP/2 را مختل می‌کنند. OneProvider هیچ محدودیت منطقه‌ای ندارد و استریم‌ها را بافر نمی‌کند؛ پروکسی را خاموش کنید و دوباره امتحان کنید.

اگر این‌ها کافی نبود از کجا بپرسم؟

در Telegram به @Oneproviderhelpbot پیام بدهید یا در حساب کاربری وب «پشتیبانی» را باز کنید و کد وضعیت HTTP و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار می‌کند .