الرؤية

حلّل الصور باستخدام نماذج المحادثة القادرة على الرؤية في Venice عبر محتوى الرسائل متعدد الوسائط في واجهة برمجة تطبيقات chat completions المتوافقة مع OpenAI.

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

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

​

الاستخدام الأساسي

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["VENICE_API_KEY"],
    base_url="https://api.venice.ai/api/v1",
)

response = client.chat.completions.create(
    model="qwen3-vl-235b-a22b",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Describe this image in three bullets."},
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://www.gstatic.com/webp/gallery/1.jpg"
                    },
                },
            ],
        }
    ],
)

print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.VENICE_API_KEY,
  baseURL: "https://api.venice.ai/api/v1",
});

const response = await client.chat.completions.create({
  model: "qwen3-vl-235b-a22b",
  messages: [
    {
      role: "user",
      content: [
        { type: "text", text: "Describe this image in three bullets." },
        {
          type: "image_url",
          image_url: {
            url: "https://www.gstatic.com/webp/gallery/1.jpg",
          },
        },
      ],
    },
  ],
});

console.log(response.choices[0].message.content);

curl https://api.venice.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3-vl-235b-a22b",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "Describe this image in three bullets."},
          {
            "type": "image_url",
            "image_url": {
              "url": "https://www.gstatic.com/webp/gallery/1.jpg"
            }
          }
        ]
      }
    ]
  }'

​

استخدام صور Base64

يمكنك أيضًا تمرير رابط بيانات بترميز base64 عندما تكون الصورة محلية أو خاصة:

{
  "type": "image_url",
  "image_url": {
    "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  }
}

​

اختيار نموذج رؤية

استخدم صفحة النماذج النصية أو واجهة برمجة تطبيقات النماذج للعثور على النماذج التي تدعم الرؤية. يُدرَج دعم الرؤية ضمن قدرات النموذج.

للمدخلات ذات الطابع المستندي، استخدم مدخلات الملفات عندما تريد من Venice استخراج نص من ملف. استخدم الرؤية عندما يكون التخطيط البصري أو محتوى الصورة نفسه هو المهم.

​

نصائح للمطالبات

• أخبر النموذج بما يجب أن يركّز عليه: الكائنات، أو النص، أو التخطيط، أو السلامة، أو العيوب، أو الاختلافات.
• اطلب مخرجات مُهيكلة عندما يحتاج تطبيقك إلى حقول يمكنك تحليلها.
• تأكّد من أن روابط الصور قابلة للوصول من واجهة برمجة التطبيقات، أو استخدم روابط بيانات base64 للصور الخاصة.
• استخدم نموذجًا بسياق كافٍ إذا كنت تدمج الصور مع تعليمات طويلة.

​

موارد ذات صلة

• واجهة برمجة تطبيقات Chat Completions
• النماذج النصية
• دليل مدخلات الملفات
• دليل الاستجابات المُهيكلة