Gemini 3 Flash API

Quickstart

This model uses the Gemini Developer API native format — the model id is in the URL path, not the request body. Compatible with the Gemini SDK (@google/generative-ai), Gemini CLI, and opencode by overriding the base URL.

bashcurl "https://api.skillboss.co/v1beta/models/gemini-3-flash-preview:generateContent" \
  -H "x-goog-api-key: $SKILLBOSS_WHOLESALE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"parts": [{"text": "Hello"}]}
    ]
  }'

Your first 200 response is the fastest way to confirm setup. From there, swap in your real prompt and tune the model-specific parameters listed below.

Authentication

Every request must include your wholesale key. The header name depends on the endpoint — match the SDK you're using:

bashx-goog-api-key: $SKILLBOSS_WHOLESALE_KEY

Gemini's native API uses x-goog-api-key (Gemini SDK + opencode default) or ?key= as a query parameter (Gemini CLI). Both work — pick whichever matches your client. Standard (non-wholesale) console keys are rejected at the gateway with 401.

Code examples

pythonimport os
from google import genai

client = genai.Client(
    api_key=os.environ["SKILLBOSS_WHOLESALE_KEY"],
    http_options={"base_url": "https://api.skillboss.co"},
)

resp = client.models.generate_content(
    model="gemini-3-flash-preview",
    contents="Hello",
)
print(resp.text)

typescriptimport { GoogleGenerativeAI } from "@google/generative-ai";

// Point the Gemini SDK at SkillBoss by overriding the base URL.
const genAI = new GoogleGenerativeAI(process.env.SKILLBOSS_WHOLESALE_KEY, {
  baseUrl: "https://api.skillboss.co",
});

const model = genAI.getGenerativeModel({ model: "gemini-3-flash-preview" });
const result = await model.generateContent("Hello");
console.log(result.response.text());

Parameters

Gemini Developer API parameters. The model id is in the URL path (not the body) — see the curl example above. Body fields documented here.

Endpoint

Errors

The API uses standard HTTP status codes:

Pricing