Getting Started with Salad AI Gateway

Make your first API call to Salad AI Gateway in under 5 minutes.

Last Updated: September 2, 2026

Salad AI Gateway is currently in beta.

Prerequisites

• A SaladCloud organization with a positive credit balance
• An organization-specific AI Gateway API key. Follow Pay-Per-Token Onboarding to create one.

Base URL

All requests go to:

https://ai.salad.cloud/v1

Authentication

Pass your organization-specific AI Gateway API key as a Bearer token in the Authorization header:

Authorization: Bearer <your-ai-gateway-api-key>

Step 1: Test with curl

The quickest way to verify access is a single curl call:

curl https://ai.salad.cloud/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SALAD_AI_GATEWAY_API_KEY" \
  -d '{
    "model": "qwen3.6-35b-a3b",
    "messages": [
      {"role": "user", "content": "Say hello in one sentence."}
    ]
  }'

You should receive a JSON response containing the model’s reply.

Step 2: Use the SaladCloud AI SDK Provider

For JavaScript and TypeScript applications built with the Vercel AI SDK, use the official @saladtechnologies-oss/ai-sdk-provider. The provider requires Node.js 22 or later and automatically uses the Salad AI Gateway base URL.

Install the provider, Vercel AI SDK, and Zod:

npm install @saladtechnologies-oss/ai-sdk-provider ai zod

The provider reads your key from SALAD_CLOUD_API_KEY. If you followed the pay-per-token onboarding guide, map the existing variable before running your application:

export SALAD_CLOUD_API_KEY="$SALAD_AI_GATEWAY_API_KEY"

Create index.mjs:

index.mjs

import { generateText } from 'ai'
import { saladCloud } from '@saladtechnologies-oss/ai-sdk-provider'

const result = await generateText({
  model: saladCloud('qwen3.6-35b-a3b'),
  prompt: 'Say hello in one sentence.',
})

console.log(result.text)

Run the example:

node index.mjs

The provider also supports streaming, tool calling, structured output, reasoning options, and image inputs. See the SaladCloud AI SDK Provider repository for configuration and additional examples.

Step 3: Use the OpenAI Python SDK

Salad AI Gateway is fully compatible with the OpenAI Python SDK — just point it at a different base URL:

pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.salad.cloud/v1",
    api_key="your-ai-gateway-api-key",
)

response = client.chat.completions.create(
    model="qwen3.6-35b-a3b",
    messages=[{"role": "user", "content": "Explain what Salad AI Gateway is in two sentences."}],
)

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

Store your key in an environment variable rather than hardcoding it:

export SALAD_AI_GATEWAY_API_KEY=your-ai-gateway-api-key

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://ai.salad.cloud/v1",
    api_key=os.environ["SALAD_AI_GATEWAY_API_KEY"],
)

Step 4: Streaming

For real-time output, enable streaming:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://ai.salad.cloud/v1",
    api_key=os.environ["SALAD_AI_GATEWAY_API_KEY"],
)

stream = client.chat.completions.create(
    model="qwen3.6-35b-a3b",
    messages=[{"role": "user", "content": "Write a short poem about distributed computing."}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Step 5: Use the OpenAI JavaScript/TypeScript SDK

npm install openai

import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://ai.salad.cloud/v1',
  apiKey: process.env.SALAD_AI_GATEWAY_API_KEY,
})

const response = await client.chat.completions.create({
  model: 'qwen3.6-35b-a3b',
  messages: [{ role: 'user', content: 'Hello from Salad AI Gateway!' }],
})

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

Available Models

Model	Context Window	Best For
qwen3.6-35b-a3b	262,144 tokens	Complex reasoning, agentic tasks, coding
qwen3.5-35b-a3b	131,072 tokens	Cost-efficient agentic tasks

See the Models Reference for full details.

Next Steps

• Browse integration guides for agentic tools, IDEs, and frameworks
• Read the Models Reference for model capabilities and limits
• Review AI Gateway Pricing for monthly subscription and pay-per-token options