إنشاء فيديو
POST/v1/videos
يبدأ مهمة فيديو غير متزامنة ويرجع فوراً بمعرّفها. تابع حالتها، ثم نزّل الملف حين تكتمل.
النماذج: optes-motion-1
معاملات الطلب
application/jsonmodelstringمطلوبoptes-motion-1.promptstringمطلوبوصف المشهد والحركة والصوت.
secondsintegerاختياريمن 4 إلى 10. الافتراضي 8.
sizestringاختياري1280x720(الافتراضي) أو720x1280أو1920x1080.audiobooleanاختياريصوت مع الفيديو. الافتراضي
true.tierstringاختياريfast(720p بلا صوت) أوstandard.imagefile | stringاختياريصورة البداية، لتحريكها.
يرجع
كائن video. وقيمة status: queued ثم in_progress ثم completed أو failed. المهمة الفاشلة لا تُحسب، والملف يبقى متاحاً للتنزيل 24 ساعة.
حالة المهمة
GET/v1/videos/{id}
يرجع كائن video نفسه بحالته الحالية، ومعه error إن فشلت.
تنزيل الملف
GET/v1/videos/{id}/content
يرجع ملف MP4 بعد أن تصير الحالة completed.
curl https://api.optes3.com/v1/videos \ -H "Authorization: Bearer $OPTES_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "optes-motion-1", "prompt": "لقطة جوية بطيئة لكورنيش عند الغروب، مع صوت الموج", "seconds": 8, "size": "1280x720" }'import os, time, httpxH = {"Authorization": f"Bearer {os.environ['OPTES_API_KEY']}"}API = "https://api.optes3.com/v1"job = httpx.post(f"{API}/videos", headers=H, json={ "model": "optes-motion-1", "prompt": "لقطة جوية بطيئة لكورنيش عند الغروب، مع صوت الموج", "seconds": 8,}).json()while job["status"] in ("queued", "in_progress"): time.sleep(5) job = httpx.get(f"{API}/videos/{job['id']}", headers=H).json()const API = "https://api.optes3.com/v1";const H = { Authorization: `Bearer ${process.env.OPTES_API_KEY}` };let job = await fetch(`${API}/videos`, { method: "POST", headers: { ...H, "Content-Type": "application/json" }, body: JSON.stringify({ model: "optes-motion-1", prompt: "كورنيش عند الغروب", seconds: 8 }),}).then((r) => r.json());while (job.status === "queued" || job.status === "in_progress") { await new Promise((r) => setTimeout(r, 5000)); job = await fetch(`${API}/videos/${job.id}`, { headers: H }).then((r) => r.json());}Response
{ "id": "video_7Kd2", "object": "video", "model": "optes-motion-1", "status": "queued", "seconds": 8, "size": "1280x720", "created_at": 1790640000}الأسعار بالدولار الأمريكي، وهي أوّلية حتى الإطلاق. الواجهة البرمجية والتسجيل والمفاتيح تُفتح يوم الإطلاق.