How to Use GraphQL API Keys with Buu AI
For developers and creators looking to integrate Buu AI directly into their apps, tools, or backend systems, the GraphQL
API offers a powerful way to automate and scale 3D generation. With just a few lines of code, you can submit prompts,
retrieve assets, and manage your usage — all through secure API calls.
In this guide, we’ll walk through how to access your API key, structure GraphQL requests, and make your first
successful 3D generation call.
🔑 Step 1: Get Your API Key
1. Log in to your Buu AI account
2. Go to API Keys
3. Click Generate API Key
4. Copy the key and store it securely
⚠️ Treat your API key like a password, anyone with this key can use your credits.
🧠 What You Can Do with the GraphQL API
The Buu AI GraphQL endpoint allows you to:
- Submit text or image prompts
- Specify generation styles
- Monitor credit usage
- Fetch generation results, including download links and metadata
This makes it ideal for:
- Creating automated pipelines
- Building custom prompt interfaces
- Embedding Buu AI inside your apps, bots, or services
📡 Endpoint Information
GraphQL API Base URL:
https://api.buu.ai/graphql
Standard headers:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
🧪 Example Query
Here’s a basic mutation that submits a prompt:
mutation {
generate3DAsset(input: {
prompt: "Magic staff with glowing blue crystal",
style: "fantasy"
}) {
id
status
previewUrl
modelUrl
}
}
Once processed, you can use the returned id to check status or download the final model file.
🧰 Checking Generation Status
To check the status of a generation:
query {
assetStatus(id: "asset_id_here") {
status
modelUrl
previewUrl
style
}
}
Statuses include:
- pending
- processing
- complete
- failed
📦 Output Format
Models are returned in standard formats:
- .glb is currently supported, .fbx and .obj is coming soon.
- Preview images and metadata.
Download links expire after a short period, so make sure to store results promptly.
📘 Coming Soon: RESTful API
We’re currently working on a RESTful API for users who prefer traditional REST endpoints over GraphQL. Full
documentation, SDKs, and Postman collections will be released in the upcoming developer update.
🧠 Pro Tips
- Create a separate API key for each environment (dev, staging, prod)
- Use rate limiting in your app logic
- Log all requests to monitor credit usage and debug errors
- Wrap API calls inside retry logic for reliability
With the GraphQL API, Buu AI becomes part of your stack, ready to generate assets at scale, on demand, and in sync with
your systems.
