Quickstart

from openai import OpenAI

client = OpenAI(
    base_url="https://gateway.toolken.ai/v1",
    api_key="sk-...",  # your provider key, forwarded untouched
    default_headers={
        "X-Toolken-Key": "tk_live_...",
        "X-Toolken-Metadata-Agent": "research-agent",
    },
)
client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello"}],
)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://gateway.toolken.ai/v1",
  apiKey: process.env.OPENAI_API_KEY, // forwarded untouched
  defaultHeaders: {
    "X-Toolken-Key": "tk_live_...",
    "X-Toolken-Metadata-Agent": "research-agent",
  },
});
await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "Hello" }],
});

package main

import (
  "bytes"
  "encoding/json"
  "io"
  "net/http"
)

func main() {
  body, _ := json.Marshal(map[string]any{
    "model":    "gpt-4o-mini",
    "messages": []map[string]string{{"role": "user", "content": "Hello"}},
  })

  req, _ := http.NewRequest("POST", "https://gateway.toolken.ai/v1/chat/completions", bytes.NewReader(body))
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("Authorization", "Bearer sk-...")      // your provider key, forwarded untouched
  req.Header.Set("X-Toolken-Key", "tk_live_...")
  req.Header.Set("X-Toolken-Metadata-Agent", "research-agent")

  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
  io.ReadAll(resp.Body)
}

require "openai"

client = OpenAI::Client.new(
  uri_base: "https://gateway.toolken.ai/v1/",
  access_token: ENV["OPENAI_API_KEY"], # forwarded untouched
  extra_headers: {
    "X-Toolken-Key" => "tk_live_...",
    "X-Toolken-Metadata-Agent" => "research-agent",
  },
)
client.chat(
  parameters: {
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "Hello" }],
  },
)

curl https://gateway.toolken.ai/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "X-Toolken-Key: tk_live_..." \
  -H "X-Toolken-Metadata-Agent: research-agent" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Hello"}]}'