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 arequest_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.