Vercel AI SDK | Documentação da API Venice

O Vercel AI SDK é a maneira mais popular de construir recursos de IA em apps Next.js, React, Svelte e Vue. A Venice funciona imediatamente como um provedor compatível com OpenAI.

Configuração

npm install ai @ai-sdk/openai

Configuração do provedor

Crie um provedor Venice usando o adaptador compatível com OpenAI:

// lib/venice.ts
import { createOpenAI } from '@ai-sdk/openai';

const openai = createOpenAI({
  apiKey: process.env.VENICE_API_KEY!,
  baseURL: 'https://api.venice.ai/api/v1',
});

// Use .chat() para garantir compatibilidade com o endpoint de chat completions da Venice
export const venice = (modelId: string) => openai.chat(modelId);

Usar .chat() garante que as requisições vão para o endpoint /chat/completions da Venice. A sintaxe padrão openai('model') pode usar endpoints mais novos da OpenAI que a Venice ainda não suporta.

Streaming de chat (Next.js App Router)

Rota de API

// app/api/chat/route.ts
import { streamText } from 'ai';
import { venice } from '@/lib/venice';

export async function POST(req: Request) {
  const { messages } = await req.json();

  const result = streamText({
    model: venice('venice-uncensored'),
    system: 'You are a helpful, privacy-respecting AI assistant.',
    messages,
  });

  return result.toDataStreamResponse();
}

Componente React

// app/page.tsx
'use client';

import { useChat } from '@ai-sdk/react';

export default function Chat() {
  const { messages, input, handleInputChange, handleSubmit, isLoading } = useChat();

  return (
    <div className="max-w-2xl mx-auto p-4">
      <div className="space-y-4 mb-4">
        {messages.map((m) => (
          <div key={m.id} className={m.role === 'user' ? 'text-right' : 'text-left'}>
            <span className="font-bold">{m.role === 'user' ? 'You' : 'Venice'}:</span>
            <p className="whitespace-pre-wrap">{m.content}</p>
          </div>
        ))}
      </div>

      <form onSubmit={handleSubmit} className="flex gap-2">
        <input
          value={input}
          onChange={handleInputChange}
          placeholder="Ask anything..."
          className="flex-1 border rounded px-3 py-2"
          disabled={isLoading}
        />
        <button type="submit" disabled={isLoading} className="bg-red-600 text-white px-4 py-2 rounded">
          Send
        </button>
      </form>
    </div>
  );
}

Gerando texto (sem streaming)

import { generateText } from 'ai';
import { venice } from '@/lib/venice';

const { text } = await generateText({
  model: venice('zai-org-glm-5-1'),
  prompt: 'Explain zero-knowledge proofs in simple terms.',
});

console.log(text);

Saída estruturada

import { generateObject } from 'ai';
import { venice } from '@/lib/venice';
import { z } from 'zod';

const { object } = await generateObject({
  model: venice('venice-uncensored'),
  schema: z.object({
    recipe: z.object({
      name: z.string(),
      ingredients: z.array(z.string()),
      steps: z.array(z.string()),
      prepTimeMinutes: z.number(),
    }),
  }),
  prompt: 'Generate a recipe for chocolate chip cookies.',
});

console.log(object.recipe.name);
console.log(`Prep time: ${object.recipe.prepTimeMinutes} minutes`);

Tool calling

import { streamText, tool } from 'ai';
import { venice } from '@/lib/venice';
import { z } from 'zod';

const result = streamText({
  model: venice('zai-org-glm-5-1'),
  messages: [{ role: 'user', content: 'What is the weather in Tokyo?' }],
  tools: {
    getWeather: tool({
      description: 'Get current weather for a location',
      parameters: z.object({
        location: z.string().describe('City name'),
      }),
      execute: async ({ location }) => {
        // Sua chamada de API de clima aqui
        return { temperature: 22, condition: 'Sunny', location };
      },
    }),
  },
});

for await (const part of result.fullStream) {
  if (part.type === 'text-delta') {
    process.stdout.write(part.textDelta);
  } else if (part.type === 'tool-result') {
    console.log('Tool result:', part.result);
  }
}

Geração de imagens

A geração de imagens Venice pode ser chamada diretamente junto com o AI SDK:

// app/api/image/route.ts
export async function POST(req: Request) {
  const { prompt } = await req.json();

  const response = await fetch('https://api.venice.ai/api/v1/image/generate', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.VENICE_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'qwen-image',
      prompt,
      width: 1024,
      height: 1024,
    }),
  });

  const data = await response.json();
  return Response.json({ image: data.images[0] });
}

Chat multi-modelo (seletor de modelo)

Deixe os usuários escolherem entre modelos Venice:

// app/api/chat/route.ts
import { streamText } from 'ai';
import { venice } from '@/lib/venice';

const ALLOWED_MODELS = [
  'venice-uncensored',
  'zai-org-glm-5-1',
  'qwen3-vl-235b-a22b',
  'qwen3-5-9b',
];

export async function POST(req: Request) {
  const { messages, model: modelId } = await req.json();

  if (!ALLOWED_MODELS.includes(modelId)) {
    return new Response('Invalid model', { status: 400 });
  }

  const result = streamText({
    model: venice(modelId),
    messages,
  });

  return result.toDataStreamResponse();
}

// Componente cliente com seletor de modelo
'use client';

import { useChat } from '@ai-sdk/react';
import { useState } from 'react';

const MODELS = [
  { id: 'venice-uncensored', name: 'Venice Uncensored', desc: 'Fast & uncensored' },
  { id: 'zai-org-glm-5-1', name: 'GLM 5.1', desc: 'Most intelligent (private)' },
  { id: 'qwen3-vl-235b-a22b', name: 'Qwen Vision', desc: 'Advanced vision + text' },
  { id: 'qwen3-5-9b', name: 'Qwen 3.5 9B', desc: 'Fastest & cheapest' },
];

export default function Chat() {
  const [model, setModel] = useState('venice-uncensored');
  const { messages, input, handleInputChange, handleSubmit } = useChat({
    body: { model },
  });

  return (
    <div>
      <select value={model} onChange={(e) => setModel(e.target.value)}>
        {MODELS.map((m) => (
          <option key={m.id} value={m.id}>{m.name} — {m.desc}</option>
        ))}
      </select>
      {/* ... UI do chat ... */}
    </div>
  );
}

Integração de busca na web

Passe parâmetros Venice para busca na web:

import { streamText } from 'ai';
import { venice } from '@/lib/venice';

const result = streamText({
  model: venice('venice-uncensored'),
  messages: [{ role: 'user', content: 'What happened in AI news today?' }],
  // Parâmetros específicos da Venice
  experimental_providerMetadata: {
    venice_parameters: {
      enable_web_search: 'auto',
    },
  },
});

Se experimental_providerMetadata não passar adiante, você pode usar um wrapper de fetch personalizado ou chamar a API Venice diretamente para recursos de busca na web.

Embeddings

Para embeddings, use textEmbeddingModel() diretamente no provedor:

import { embed, embedMany } from 'ai';
import { createOpenAI } from '@ai-sdk/openai';

const openai = createOpenAI({
  apiKey: process.env.VENICE_API_KEY!,
  baseURL: 'https://api.venice.ai/api/v1',
});

// Embedding único
const { embedding } = await embed({
  model: openai.textEmbeddingModel('text-embedding-bge-m3'),
  value: 'Privacy-first AI infrastructure',
});

// Embeddings em batch
const { embeddings } = await embedMany({
  model: openai.textEmbeddingModel('text-embedding-bge-m3'),
  values: [
    'Venice AI provides private inference.',
    'Zero data retention guaranteed.',
    'OpenAI SDK compatible.',
  ],
});

Variáveis de ambiente

# .env.local
VENICE_API_KEY=your-venice-api-key

Modelos recomendados

Caso de uso	Modelo	Por quê
Apps de chat	`venice-uncensored`	Rápido, barato, sem filtragem
Tarefas complexas	`zai-org-glm-5-1`	Raciocínio flagship privado
Apps de visão	`qwen3-vl-235b-a22b`	Compreensão de imagem avançada
Alto volume	`qwen3-5-9b`	Mais barato, $0,10/1M de entrada,$ 0,15/1M de saída
Tool calling	`zai-org-glm-5-1`	Function calling confiável

Documentação do Vercel AI SDK

Documentação oficial do Vercel AI SDK

Modelos Venice

Navegue por todos os modelos Venice

​Configuração

​Configuração do provedor

​Streaming de chat (Next.js App Router)

​Rota de API

​Componente React

​Gerando texto (sem streaming)

​Saída estruturada

​Tool calling

​Geração de imagens

​Chat multi-modelo (seletor de modelo)

​Integração de busca na web

​Embeddings

​Variáveis de ambiente

​Modelos recomendados

Documentação do Vercel AI SDK

Modelos Venice

Configuração

Configuração do provedor

Streaming de chat (Next.js App Router)

Rota de API

Componente React

Gerando texto (sem streaming)

Saída estruturada

Tool calling

Geração de imagens

Chat multi-modelo (seletor de modelo)

Integração de busca na web

Embeddings

Variáveis de ambiente

Modelos recomendados