الدرس 3 من 3 · ٩ دقائق

أرسل الصور والصوت

أضف صورًا وملفات وصوتًا إلى طلب، واختر نقطة النهاية المناسبة للمخرجات التي تريدها، واعثر على النماذج التي تقبل كل نوع من المدخلات.

في نقاط النهاية النصية، يمكن أن يكون content في الرسالة قائمة أجزاء بدلًا من سلسلة نصية. يقبل جزء الصورة عنوان URL من نوع HTTP(S) أو URI من نوع data: بترميز base64:

{
  "model": "anthropic/claude-sonnet-5.5",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "What does this chart show?" },
        { "type": "image_url", "image_url": { "url": "https://example.com/chart.png" } }
      ]
    }
  ]
}

تتبع أجزاء الإدخال الأخرى النمط نفسه. يرسل input_audio صوتًا بترميز base64 في data مع format مثل wav أو mp3. ويرسل جزء file مستندًا مثل PDF، إما كعنوان data URL بترميز base64 في file_data أو كـ file_id. لا يمكن قراءة file_id إلا من حساب المزوّد الذي أصدره، لذا ثبّت ذلك المزوّد أو أرسل البيانات بدلًا منه.

للأنواع الأخرى من المخرجات، استخدم نقطة النهاية الخاصة بها:

ما تريدهنقطة النهاية
كلام من نص/v1/audio/speech
نص من كلام/v1/audio/transcriptions (/v1/audio/translations للإنجليزية)
الصور/v1/images/generations، /v1/images/edits
النص والتخطيط من صورة مستند/v1/ocr، /v1/parse

يقبل /v1/parse صورة واحدة لكل طلب ولا يقبل ملفات PDF، لذا حوّل كل صفحة إلى صورة أولًا.

ليس كل نموذج يقبل كل نوع من المدخلات. توجّه Phaseo الطلب فقط إلى المزوّدين الذين يقبلون المدخلات في طلبك، وإذا لم يقبلها أي منهم، تحصل على 400 unsupported_modalities. تحقّق أولًا: كل نموذج في GET /v1/models يسرد modalities.input، ويمكنك التصفية بـ input_types=image. وفي صفحة النماذج، استخدم فلاتر أنماط الإدخال والإخراج.

تحقّق من فهمك

تحتاج إلى قائمة بالنماذج التي تقبل الصور كمدخلات. ما أسرع طريقة موثوقة للتحقق؟

طبّق ما تعلّمته

ترسل ميزة الإيصالات لديك صورة إلى نموذج نصي فقط وتحصل على 400 unsupported_modalities. يسأل مدير المنتج هل Phaseo متوقفة. ماذا تقول له، وماذا تغيّر؟

اعرض الإجابة

لا، Phaseo ليست متوقفة: لا يوجد مسار لذلك النموذج يقبل الصور كمدخلات. اختر نموذجًا يتضمن modalities.input فيه image (صفِّ GET /v1/models بـ input_types=image، أو استخدم فلتر صفحة النماذج) وأرسل الطلب نفسه إليه.

الخلاصة

أرسل الصور والصوت والملفات كأجزاء محتوى، واستخدم نقاط النهاية المخصصة للكلام والتفريغ النصي والصور، وتحقّق من أنماط إدخال النموذج قبل أن تعتمد عليه.

روابط ذات صلة

يُحفظ تقدّمك في هذا المتصفح.

آخر مراجعة: ١٧ نوفمبر ٢٠٢٦