视觉 | Venice API 文档

基本用法

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 数据 URL：

{
  "type": "image_url",
  "image_url": {
    "url": "data:image/png;base64,<BASE64_ENCODED_IMAGE>"
  }
}

将 <BASE64_ENCODED_IMAGE> 替换为图片文件的完整 base64 编码，例如在 Python 中使用 base64.b64encode(open("photo.png", "rb").read()).decode()。

Base64 图片必须以 data:image/<type>;base64, 前缀开头（例如 data:image/jpeg;base64,）。不带前缀的原始 base64 会被拒绝。图片尺寸必须至少为 64×64 像素，且不支持 SVG。如果图片被拒绝，错误消息会说明原因。

选择视觉模型

可在文本模型页面或通过 Models API 查找支持视觉的模型。模型能力列表中会标明其是否支持视觉。

对于类文档类的输入，如果希望 Venice 从文件中提取文本，请使用文件输入。当视觉版式或图像内容本身很重要时，才使用视觉能力。

提示词建议

明确告诉模型关注的重点：物体、文字、版式、安全性、缺陷或差异等。

如果你的应用需要可解析的字段，请要求模型给出结构化输出。

保证图片 URL 对 API 可访问，或对私有图片使用 base64 数据 URL。

若图片会与较长指令一起使用，请选择具有足够上下文长度的模型。

文档

快速开始

文本与聊天

图像

视频

音频

搜索与 RAG

智能体与集成

编程工具

智能体工具

SDK 与框架

视觉

基本用法

使用 Base64 图片

选择视觉模型

提示词建议

相关资源

​基本用法

​使用 Base64 图片

​选择视觉模型

​提示词建议

​相关资源

基本用法

使用 Base64 图片

选择视觉模型

提示词建议

相关资源