Team Workspaces and API Access

Yeehoo external APIs are available only to team workspaces. Personal workspaces support personal products and subscriptions, but cannot create or call API keys.

Prerequisite

Create or switch to an active team workspace in the console first. The workspace Owner or Admin can create and manage API keys for that workspace.

An API key is permanently owned by the team workspace in which it is created. The following all belong to that key's team workspace:

• Credit balance, charges, and usage
• Image and video tasks
• Reference uploads and generated assets
• Model permissions, allowed models, and webhook delivery

Integration flow

1. Create or switch to a team workspace in the console.
2. Create an API key and configure scopes, allowed models, and webhook delivery as needed.
3. Call GET /v1/models to confirm the models available to the key.
4. When using a reference image, call Image Upload first and pass the returned URL to generation.
5. For image or video, call POST /v1/quote for estimated credits, then POST /v1/generations to create a task.
6. Poll GET /v1/tasks/{task_id} for a terminal state or receive a webhook notification.

Do not switch workspaces with a header

/v1/* resolves the team workspace exclusively from the API key in Authorization: Bearer; it does not read X-Yeehoo-Workspace-ID. Supplying or forging that header cannot alter billing, task, or asset ownership.

To use another team workspace, create and use an API key from that workspace.