Docs

Godance is a drop-in OpenAI-compatible REST API. If you've shipped against the OpenAI SDK, you already know the shape of every endpoint below — same JSON, same error codes, same streaming format.

Get to first call in three steps

1. Create an account and mint an API key in Settings → API Keys (returned in plaintext once — save it).
2. Top up with card (Stripe) or USDC (Coinbase Commerce). Same balance, same API.
3. Point your OpenAI SDK at https://api.godance.ai/v1 and start switching model values.

Endpoint reference

• POST /v1/chat/completions — streaming + non-streaming
• POST /v1/images/generations — sync + async (HQ models auto-promote)
• POST /v1/videos/generations — async-only, signed webhook
• GET /v1/jobs/{id} — async job status
• CRUD /v1/keys — API key management
• POST /v1/billing/topup — credit top-up via Stripe Checkout
• GET /v1/webhooks/secret — signing secret + verification guide

Webhook signature verification

Outbound webhooks carry an X-Godance-Signature header in Stripe format: t=<unix>,v1=<hex>[,v1=<hex>...]. During the 24-hour grace window after a secret rotation, two v1= entries are included — verify against your stored secret and accept on ANY match.

import hmac, hashlib

def verify(payload, header, secret):
    t = int(header.split(',')[0][2:])
    sigs = [p[3:] for p in header.split(',') if p.startswith('v1=')]
    expected = hmac.new(
        secret.encode(), f"{t}.{payload}".encode(),
        hashlib.sha256
    ).hexdigest()
    return any(hmac.compare_digest(expected, s) for s in sigs)

Full reference docs land Session 11. Until then, email us with questions.