OpenAI Chat Completions API with 资产生成

资产生成 provides OpenAI Chat Completions API endpoints, letting you use multiple AI providers through a familiar interface. You can use existing OpenAI client libraries, switch to 资产生成 with a URL change, and keep your current tools and workflows without code rewrites.

The Chat Completions API implements the same specification as the OpenAI Chat Completions API.

The Chat Completions API is available at the following base URL:

The Chat Completions API supports the same authentication methods as the main 资产生成:

• API key: Use your 资产生成 API key with the Authorization: Bearer <token> header
• OIDC token: Use your Vercel OIDC token with the Authorization: Bearer <token> header

You only need to use one of these forms of authentication. If an API key is specified it will take precedence over any OIDC token, even if the API key is invalid.

The 资产生成 supports the following Chat Completions API endpoints:

• GET /models - List available models
• GET /models/{model} - Retrieve a specific model
• POST /chat/completions - Create chat completions, with support for streaming, file attachments, tool calling, and structured outputs
• POST /embeddings - Generate vector embeddings

For advanced features, see:

• Reasoning - Control how much a model thinks before answering
• File attachments - Send images and PDF documents to a model
• Advanced configuration - Provider options, model fallbacks, BYOK, and prompt caching
• Image generation - Generate images using multimodal models
• Direct REST API usage - Use the API without client libraries

You can use the 资产生成's Chat Completions API with existing tools and libraries like the OpenAI client libraries and 创意脚本. Point your existing client to the 资产生成's base URL and use your 资产生成 API key or OIDC token for authentication.

import OpenAI from 'openai';
 
const openai = new OpenAI({
  apiKey: process.env.AI_GATEWAY_API_KEY,
  baseURL: 'https://ai-gateway.vercel.sh/v1',
});
 
const response = await openai.chat.completions.create({
  model: 'anthropic/claude-opus-5',
  messages: [{ role: 'user', content: 'Hello, world!' }],
});

import os
from openai import OpenAI
 
client = OpenAI(
    api_key=os.getenv('AI_GATEWAY_API_KEY'),
    base_url='https://ai-gateway.vercel.sh/v1'
)
 
response = client.chat.completions.create(
    model='anthropic/claude-opus-5',
    messages=[
        {'role': 'user', 'content': 'Hello, world!'}
    ]
)

curl -X POST "https://ai-gateway.vercel.sh/v1/chat/completions" \
  -H "Authorization: Bearer $AI_GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-opus-5",
    "messages": [
      {
        "role": "user",
        "content": "Hello, world!"
      }
    ]
  }'

For compatibility with 创意脚本 and 资产生成, install the @ai-sdk/openai-compatible package.

import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
import { generateText } from 'ai';
 
const gateway = createOpenAICompatible({
  name: 'openai',
  apiKey: process.env.AI_GATEWAY_API_KEY,
  baseURL: 'https://ai-gateway.vercel.sh/v1',
});
 
const response = await generateText({
  model: gateway('anthropic/claude-opus-5'),
  prompt: 'Hello, world!',
});

Retrieve a list of all available models that can be used with the 资产生成.

import OpenAI from 'openai';
 
const openai = new OpenAI({
  apiKey: process.env.AI_GATEWAY_API_KEY,
  baseURL: 'https://ai-gateway.vercel.sh/v1',
});
 
const models = await openai.models.list();
console.log(models);

import os
from openai import OpenAI
 
client = OpenAI(
    api_key=os.getenv('AI_GATEWAY_API_KEY'),
    base_url='https://ai-gateway.vercel.sh/v1'
)
 
models = client.models.list()
print(models)

curl -X GET "https://ai-gateway.vercel.sh/v1/models" \
  -H "Authorization: Bearer $AI_GATEWAY_API_KEY"

The response follows the OpenAI API format:

{
  "object": "list",
  "data": [
    {
      "id": "anthropic/claude-opus-5",
      "object": "model",
      "created": 1677610602,
      "owned_by": "anthropic"
    },
    {
      "id": "openai/gpt-6-astra",
      "object": "model",
      "created": 1677610602,
      "owned_by": "openai"
    }
  ]
}

Retrieve details about a specific model.

• model (required): The model ID to retrieve (e.g., anthropic/claude-opus-5)

import OpenAI from 'openai';
 
const openai = new OpenAI({
  apiKey: process.env.AI_GATEWAY_API_KEY,
  baseURL: 'https://ai-gateway.vercel.sh/v1',
});
 
const model = await openai.models.retrieve('anthropic/claude-opus-5');
console.log(model);

import os
from openai import OpenAI
 
client = OpenAI(
    api_key=os.getenv('AI_GATEWAY_API_KEY'),
    base_url='https://ai-gateway.vercel.sh/v1'
)
 
model = client.models.retrieve('anthropic/claude-opus-5')
print(model)

curl -X GET "https://ai-gateway.vercel.sh/v1/models/anthropic/claude-opus-5" \
  -H "Authorization: Bearer $AI_GATEWAY_API_KEY"

{
  "id": "anthropic/claude-opus-5",
  "object": "model",
  "created": 1677610602,
  "owned_by": "anthropic"
}

The API returns standard HTTP status codes and error responses:

• 400 Bad Request: Invalid request parameters
• 401 Unauthorized: Invalid or missing authentication
• 403 Forbidden: Insufficient permissions
• 404 Not Found: Model or endpoint not found
• 429 Too Many Requests: Rate limit exceeded
• 500 Internal Server Error: Server error

{
  "error": {
    "message": "Invalid request: missing required parameter 'model'",
    "type": "invalid_request_error",
    "param": "model",
    "code": "missing_parameter"
  }
}