Install
Configure the provider
Generate text
Use provider aliases
Use public catalog IDs exactly as Compose exposes them:gpt-5.5 and openai/gpt-5.5 are different public IDs. They resolve to different provider rows.
Keep receipts out of AI SDK streams
Use/external/v1 with AI SDK. External routes keep response bodies OpenAI-shaped and do not inject Compose receipt events into the stream.
If your backend needs receipts, call native /v1/* directly and read X-Receipt.