Your first API call in under 5 minutes
The neww.ai API is OpenAI-compatible. If you already use the OpenAI SDK you only need to swap the base URL and key.
1
Create an account
Sign up — free tier includes 500 calls/month. Verify your email, then land on the dashboard.
2
Top up prepaid credits (optional for free tier)
Free-tier keys get 500 included calls. Past that, calls are debited from your prepaid wallet. Add credits at /dashboard/billing/credits — minimum $10. You’ll be redirected to Stripe Checkout; on completion the balance appears within seconds.
3
Generate an API key
Head to /dashboard/api-keys and click Create key. The raw key is shown once — copy it now. We only store the SHA-256 hash.
4
Make the call
curl -X POST https://api.neww.ai/v1/public/chat \
-H "Authorization: Bearer $NEWW_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{"role": "user", "content": "Hello, neww.ai!"}
]
}'The response is OpenAI-format:
{
"id": "chatcmpl-xxx",
"object": "chat.completion",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "..."},
"finish_reason": "stop"
}],
"usage": { "prompt_tokens": 12, "completion_tokens": 32, "total_tokens": 44 }
}5
Inspect what happened
- • Usage: /dashboard/usage shows per-request rows (latency, status, cost).
- • Balance: /dashboard/billing/credits shows current credits and purchase history.
- • Errors: every error includes a
request_idin both the body and thex-request-idresponse header — include it in any support ticket.
Common error codes
invalid_api_keyHTTP 401Key not found or revoked.missing_api_keyHTTP 401No Authorization header.insufficient_creditsHTTP 402Wallet balance below per-call cost. Top up.rate_limit_exceededHTTP 429 · retryablePlan rate limit hit; retry after 60s.scope_deniedHTTP 403Your plan does not include this API surface.upstream_errorHTTP 502 · retryableUpstream AI provider failed; retry.