> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nunchux.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Authenticate every request with your API key in the `X-API-Key` header or `Authorization: Bearer`. Keys start with `sk-nunchux-`.
> Image generation is synchronous: the image is in the response.
> Video generation is asynchronous: submit the job, poll its task until it reaches a terminal status, then download the output promptly, because output URLs expire.

# Teams

> Create a team, invite members, and switch between teams.

# Teams

### Share one balance and one bill with the people you work with.

## How teams work

Every Nunchux account is a team. When you sign up, you get your own team, listed as "Your team" in the account switcher. It holds your credits, and you are its admin.

A team you create is a separate account. It has its own credit balance, billing, API keys, plan, and [rate limits](https://docs.nunchux.ai/rate-limits.md). Nothing moves between your own team and a team you create.

The dashboard calls a team an organization in some places, such as the ORGANIZATION section of the sidebar and the Organization Settings page.

## Create a team

**1. Open the account switcher**

In the dashboard sidebar, select the account name under the logo.

**2. Select Create team**

Give the team a name, then create it.

The new team becomes the active team, and the dashboard opens its Organization Settings page. You are its admin.

A new team starts with no credits. Before anyone uses it, [add credits](https://nunchux.ai/dashboard/admin/billing) or [redeem a promo code](https://docs.nunchux.ai/promo-codes.md).

## Invite members

**1. Open Members**

With the team active, select Members under ORGANIZATION in the sidebar, or go to [Members](https://nunchux.ai/dashboard/admin/members).

**2. Send the invite**

Select the invite button, enter the person's email address, choose a role, and select Send invite.

The person gets an email invitation. Once they accept it, the team appears in their account switcher. Until then, the invitation is listed on the Members page, where an admin can revoke it.

## Roles

A team has two roles: Admin and Member. An admin can change a member's role on the Members page.

| Action | Admin | Member |
| - | - | - |
| Use the team in the playground | Yes | Yes |
| Create API keys billed to the team | Yes | Yes |
| Manage API keys | Every key on the team | Only the keys they created |
| Add credits, redeem promo codes, and manage the card and auto top-up | Yes | No |
| Invite and remove members, and change roles | Yes | No |
| See Members, Member Usage, Billing & Invoices, Team Analytics, and Organization Settings | Yes | No |
| Receive billing emails, such as low-balance alerts | Yes | No |

Only the person who created a key can rotate it, even on a team where an admin manages every key.

## Switch teams

Open the account switcher in the sidebar and select a team. A check marks the active team. The dashboard, the playground, and the keys you create from then on use that team.

## Who pays for usage

* A request from the playground or the dashboard bills the active team.
* An API key bills the team that was active when the key was created. It keeps billing that team, whoever sends the request and whichever team is active later. The key creation window names the team the key bills.
* `GET /v1/credits` with a team's key returns that team's balance and caps. Every key billed to a team shares the team's [rate limits](https://docs.nunchux.ai/rate-limits.md).

Switching teams does not move a key or its usage. To bill a different team, switch to it and create a new key there.

## Remove a member or delete a team

An admin removes a member from the Members page. Removing a member revokes every API key they created on the team. A member cannot leave a team on their own; ask an admin to remove you.

An admin deletes a team from Organization Settings. Deleting a team cannot be undone:

* Any remaining balance is forfeited. It does not move to another team.
* Every API key billed to the team stops working.
* Every member loses access.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.