Quickstart

1. Create an account

   Go to fishtoken.ai/register. Choose a username and a password, enter your email address, and type in the verification code sent to that address.

2. Add balance

   FishToken is prepaid. In the console, top up with one of the payment methods shown on the top-up page, or redeem a code. The balance does not expire.

3. Create an API key

   Open API keys in the console and create a key. Keep it secret: do not put it in front-end code or public repositories. Store it as an environment variable:

   Terminal

   export FISHTOKEN_API_KEY=your-key-here

4. Make your first call

   Use the base URL https://fishtoken.ai/v1 with any OpenAI-compatible SDK.

Python

Install the SDK: pip install openai

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://fishtoken.ai/v1",
    api_key=os.environ["FISHTOKEN_API_KEY"],
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "user", "content": "Write a two-line caption for a handmade batik tote bag."}
    ],
)
print(resp.choices[0].message.content)

Node.js

Install the SDK: npm install openai. The example uses ES modules (save it as first-call.mjs).

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://fishtoken.ai/v1",
  apiKey: process.env.FISHTOKEN_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [
    { role: "user", content: "Write a two-line caption for a handmade batik tote bag." },
  ],
});
console.log(resp.choices[0].message.content);

curl

curl https://fishtoken.ai/v1/chat/completions \
  -H "Authorization: Bearer $FISHTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "user", "content": "Write a two-line caption for a handmade batik tote bag."}
    ]
  }'

Next steps

Guides

Longer walkthroughs with runnable code.

If something goes wrong

Authentication error

Check that the request sends Authorization: Bearer followed by your FishToken key, and that the base URL is https://fishtoken.ai/v1.

Model not found

Use the model ID exactly as listed on the models page, for example deepseek-v4-flash.

Balance or quota error

Add balance in the console, then retry.

Too many requests

Standard accounts can send 60 requests per minute and accounts that have topped up can send 120. Slow down and retry with a short back-off.

Still stuck

Email support@fishtoken.ai with the time of the request and the error message. Do not send your API key.