شروع سریع

این راهنما یک تولید تصویر را از ابتدا تا انتها نشان می‌دهد. به یک کلید API نیاز دارید (بخش احراز هویت را ببینید).

۱. انتخاب مدل

GET /v1/models مدل‌های فعال و model_code آن‌ها را فهرست می‌کند.

curl https://api.anahid.example/v1/models \
-H 'Authorization: Bearer sk_live_...'

۲. ساخت کار (Job)

POST /v1/jobs را با model_code و input_params فراخوانی کنید. مقدار data در پاسخ، یک job با status برابر queued است.

curl -X POST https://api.anahid.example/v1/jobs \
-H 'Authorization: Bearer sk_live_...' \
-H 'Content-Type: application/json' \
-d '{"model_code":"flux-schnell","input_params":{"prompt":"a cat"}}'

۳. انتظار تا اتمام

GET /v1/jobs/{id} را تا زمانی که status نهایی شود (completed، failed، canceled) فراخوانی کنید. برای به‌روزرسانی زنده می‌توانید WebSocket /v1/jobs/{id}/stream?token=... را باز کنید.

curl https://api.anahid.example/v1/jobs/JOB_ID \
-H 'Authorization: Bearer sk_live_...'

۴. خواندن خروجی‌ها

GET /v1/jobs/{id}/result خروجی‌ها (نشانی تصاویر) را برمی‌گرداند.

هر پاسخ از پوشش { success, data, meta } استفاده می‌کند؛ تصاویر تولیدشده زیر data.outputs هستند.