برنامه‌نویس‌ها

API عمومی نسخهٔ ۱ — جستجو، اطلاعات و ساخت عکس و ویدیو

شروع سریع

از تنظیمات داشبورد یک کلید API بسازید.
فایل OpenAPI را از /api/v1/openapi.json بخوانید.
با توکن Bearer درخواست بزنید؛ برای نوشتن از scope مربوط به تولید استفاده کنید.

ساخت محتوا (نوشتن)

سرور باید امکان نوشتن از API فعال باشد. اعتبار از همان حساب کاربر کسر می‌شود.

POST /api/v1/generations
Authorization: Bearer axeto_...
Content-Type: application/json

{
  "type": "image",
  "model": "flux-pro",
  "prompt": "A cinematic poster..."
}

ساخت ویدیو

نوع video با slug مدل ویدیو. پارامترها: مدت، کیفیت و نسبت تصویر.

POST /api/v1/generations
{
  "type": "video",
  "model": "seedance-1-pro",
  "prompt": "Slow pan over a city at dusk",
  "params": { "duration": 5, "resolution": "720p" }
}

احراز هویت

همه درخواست‌های نوشتن نیاز به هدر Authorization: Bearer <api_key> دارند. کلیدها در داشبورد ساخته می‌شوند.

قیمت API

هر ساخت از اعتبار همان کاربر کسر می‌شود. نرخ تبدیل اعتبار به تومان در /pricing آمده است.

قیمت API

محدودیت سرعت

پیش‌فرض: ۶۰ درخواست در دقیقه برای هر کلید. ساخت‌ها async هستند — وضعیت را با GET /api/v1/generations/:id بگیرید.

کدهای خطا

۴۰۱ بدون دسترسی · ۴۰۳ ممنوع · ۴۰۲ اعتبار کم · ۴۲۹ محدودیت · ۵۰۳ غیرفعال

وب‌هوک‌ها

در تنظیمات آدرس وب‌هوک ثبت کنید. رویدادها: اتمام ساخت، خطا، فروش و تسویه. امضا را در هدر X-Axeto-Signature بررسی کنید.

رویدادها

اتمام ساخت · خطا · فروش · تسویه