موارد المطورين

Prompts

ابحث في أمثلة الموجّهات المنشورة واقرأ وسائط الأمثلة والصور المرجعية لكل موجّه.

تُعيد Prompts API أمثلة الموجّهات المنشورة مع نقاط النهاية التي يمكنها تشغيلها. وهي عامة ولا تتطلب مفتاح API.

عرض قائمة الموجّهات

SHELL

curl "https://runapi.ai/api/v1/prompts?modality=video&q=sunset&limit=20"

صفِّ النتائج باستخدام modality وcategory وtags (مفصولة بفواصل) وq وmodel. قسّم الصفحات باستخدام page وlimit (100 كحد أقصى). تحتوي الاستجابة على prompts وpagination (page وper_page وtotal وpages).

جلب موجّه

SHELL

curl "https://runapi.ai/api/v1/prompts/PROMPT_ID"

حقول الموجّه

الحقل الوصف id معرّف الموجّه. title, prompt, negative_prompt العنوان ونص الموجّه والموجّه السلبي الاختياري. language, modality, input_kind, category, tags البيانات الوصفية للموجّه. preview_url رابط صورة الغلاف، أو null عندما لا تكون للموجّه صورة مثال. media جميع عناصر الأمثلة والعناصر المرجعية بترتيب المصدر. انظر أدناه. source_url, published_at صفحة المصدر الأصلية ووقت النشر. eligible_endpoints نقاط النهاية التي يمكنها تشغيل الموجّه.

الوسائط

يصف كل عنصر في media ملفًا واحدًا مرفقًا بالموجّه:

الحقل الوصف role example_output أو preview لنتائج الأمثلة؛ وreference_input لصورة مرجعية يجب أن يقدّمها المستخدم. قد تكون null. modality image أو video أو audio بأحرف صغيرة. قد تكون null. media_type نوع MIME، مثل video/mp4. قد تكون null. url رابط الملف. العنصر المستخدم كغلاف له الرابط نفسه في preview_url. alt_text وصف نصي، أو null.

JSON

"media": [
  {"role": "example_output", "modality": "video", "media_type": "video/mp4", "url": "https://example.test/clip.mp4", "alt_text": null},
  {"role": "reference_input", "modality": "image", "media_type": "image/png", "url": "https://example.test/face.png", "alt_text": "Face"}
]

الموجّه الذي يحتوي على عنصر reference_input لا يعطي نتائج مشابهة لأمثلته إلا عندما تقدّم صورتك المرجعية الخاصة. الموجّه الذي يحتوي على فيديو فقط يكون فيه preview_url: null؛ اقرأ مقاطع الفيديو من media.