توسعهدهندگان
یک قرارداد API برای همهٔ محصولات
هر محصول Castix یک HTTP API با سبک یکسان ارائه میدهد که با OpenAPI 3.1 توصیف شده، همراه با SDK برای TypeScript و Python.
01
نسخهبندیشده
همهٔ endpointها زیر /v1 قرار دارند. تغییرات ناسازگار نسخهٔ جدید میگیرند.
02
دو روش احراز هویت
توکن Bearer یا هدر X-API-Key بفرستید، هرکدام که با استک شما سازگارتر است.
03
استعلام قیمت رایگان
هر کار پولی یک endpoint استعلام قیمت دارد که هزینهای ندارد، تا پیش از اجرا قیمت را بدانید.
04
دفتر کل، نه موجودی
مصرف بهصورت ردیفهای دفتر کل ثبت میشود که میتوانید سطر به سطر تطبیق دهید.
05
وبهوکهای امضاشده
رویدادهای کار و استریم با امضای HMAC-SHA256 تحویل میشوند.
06
خطاهایی که میگویند چه کنید
هر خطا جملهای به زبان شماست که میگوید چطور رفعش کنید.
/v1
نمونه: استعلام قیمت یک کار دوبله
# Free: price a dubbing job before you run it
curl -X POST https://api.castix.net/v1/dub/quote \
-H "X-API-Key: $CASTIX_KEY" \
-H "Content-Type: application/json" \
-d '{"source_url":"https://example.com/ep01.mp4","target":"fa","speakers":"auto"}'
# 200 OK (illustrative response shape)
{ "quote_id": "q_…", "minutes": 12.4, "currency": "USD", "expires_in": 900 }
مستندات مرجع کامل با پیشنمایش توسعهدهندهٔ هر محصول منتشر میشود. برای دسترسی زودهنگام درخواست دهید.