Getting started Getting started

1. 1
   Send request Include stream: true
2. 2
   Open connection Keep the HTTP connection open
3. 3
   Streaming server-sent events arrive as tokens
4. 4
   Done Stream ends with [DONE]

See what's free right now in the pricing catalogue — filter by "Free" there.

strict

Bangkok only, never another region. No model is served from Bangkok yet, so requests under strict are currently refused with a 400.

regional

The default. The nearest region is tried first — Bangkok, then Singapore, then Tokyo — and a model not served in any of them goes to the provider’s global region, which can be outside Asia.

available

Only for organisations that ask for it in writing. Reaches everything regional does plus providers in mainland China, and is required for image and video models served outside Bangkok, Singapore and Tokyo.

Topping up

Who can top up

The organisation’s owner and admins. Other members can send them a top-up request from the portal.

Amount

At least ฿300, in baht with up to two decimals. That amount is the credit you get; 7% VAT is added on top when you pay.

How to pay

PromptPay QR (the default) or credit / debit card. A QR is valid for 30 minutes, and the portal checks the payment status for you.

Paid but no credit

Upload a photo of the bank slip on that top-up. Our staff check it against the bank’s record before adding the credit — a slip never adds credit on its own.

Tax invoices and withholding tax

Every top-up

Give a buyer name and email and you get an abbreviated tax invoice.

Full tax invoice

Choose a full tax invoice when you top up, then give the 13-digit tax ID, whether the buyer is an individual or a juristic person, and the address. A juristic person also gives its 5-digit branch code — 00000 for head office, otherwise the branch name as well.

Withholding tax (3%)

For organisation (B2B) accounts. Pay the full amount, then the owner or an admin claims back the 3% in the portal: upload the withholding tax certificate (50 Tawi) as an image or PDF of up to 10 MB and pick the top-ups it covers — one certificate can cover several. Only paid top-ups of ฿1,000 or more before VAT qualify, and the 3% is worked out on the amount before VAT. Once our staff approve the claim, the 3% is added to your credit.

resp = client.chat.completions.create(
    model="app/accounting-helper",
    messages=[{"role": "user", "content": "Taxi to see a client, 250 baht"}],
)
print(resp.choices[0].message.content)

Good to know

Who sets them up

Owners and admins create, edit, switch off and delete assistants in the portal. Other members can use and try them.

Change it without touching your system

The model and the instructions live with us. Edit them in the portal and the next call uses the new version. Every edit is saved as a version you can go back to.

What you pay

Per token at the chosen model’s price, exactly as if you called that model yourself. The stored instructions and examples count as input tokens on every call, so shorter instructions cost less. There is no extra fee for using an assistant.

What you send

Your messages go after the stored instructions. The length of the answer is capped at the lower of the assistant’s own limit and the max_tokens you send. When the assistant sets a temperature or an output format, the assistant wins, not the request.

Structured data (JSON)

An assistant set to return JSON always answers in the structure defined for it, and can only use a model that supports structured output.

Listing and usage

GET /v1/models includes your organization’s assistants, as app/<name>, next to the models. Fetching a single one with GET /v1/models/app/<name> is not supported. The portal’s Usage page shows which assistant each request went through.

Errors specific to assistants

Errors come back as {"error": {"message": …}} with the HTTP status. Balance (402) and rate-limit (429) errors are exactly as above.