Quickstart

This page gets you to a first successful call: create a key, pick a protocol, send a request.

Create an API key

Sign in to the Fenno API console .
Open the console’s API-key management area and create a key using the available controls.
Save it as instructed by the console. Do not assume the full value can be displayed again later.

Never commit keys to a repository or ship them in frontend code. Inject them via environment variables, for example FENNO_API_KEY.

Export the key and an exact available Chat Completions model ID in the shell running the examples below. Replace both placeholders; model IDs are available in the console or model discovery.


export FENNO_API_KEY="<your-api-key>"
export FENNO_MODEL="<your-model-id>"

Configure the base URL

Protocol	Base URL
OpenAI compatible	`https://api.fenno.ai/v1`
Anthropic native	`https://api.fenno.ai`
Gemini native	`https://api.fenno.ai`

Send the first request

cURL


curl https://api.fenno.ai/v1/chat/completions \
  -H "Authorization: Bearer $FENNO_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<JSON
  {
    "model": "$FENNO_MODEL",
    "messages": [{"role": "user", "content": "Explain a unified API gateway in one sentence"}]
  }
JSON

Python (OpenAI SDK)


import os
from openai import OpenAI
 
client = OpenAI(
    base_url="https://api.fenno.ai/v1",
    api_key=os.environ["FENNO_API_KEY"],
)
 
resp = client.chat.completions.create(
    model=os.environ["FENNO_MODEL"],
    messages=[{"role": "user", "content": "Explain a unified API gateway in one sentence"}],
)
print(resp.choices[0].message.content)

Node.js (OpenAI SDK)


import OpenAI from 'openai'
 
const client = new OpenAI({
  baseURL: 'https://api.fenno.ai/v1',
  apiKey: process.env.FENNO_API_KEY
})
 
const resp = await client.chat.completions.create({
  model: process.env.FENNO_MODEL!,
  messages: [{ role: 'user', content: 'Explain a unified API gateway in one sentence' }]
})
console.log(resp.choices[0].message.content)

Wire up coding tools


# Claude Code
export ANTHROPIC_BASE_URL="https://api.fenno.ai"
export ANTHROPIC_AUTH_TOKEN="$FENNO_API_KEY"


# Codex / OpenAI-compatible tools
export OPENAI_BASE_URL="https://api.fenno.ai/v1"
export OPENAI_API_KEY="$FENNO_API_KEY"

Full configurations live under Integrations.

Troubleshooting

Symptom	What to check
`401 Unauthorized`	Key truncated, deleted or disabled
`404 Not Found`	Missing or duplicated `/v1` in the base URL
`429 Too Many Requests`	Rate limited — see Errors & retries
Model not found	Model identifier, or account permissions for that model