Skip to main content

​
Get started in three steps

Generate your first AI image with the Firemoon Studio API.

​
Step 1: Get your API key

Contact us to get your API key for the Firemoon Studio platform.
Include your use case and expected usage volume for faster approval.
Your API key provides access to generate content. Keep it secure:
  • Store it as an environment variable
  • Never commit it to version control
  • Rotate keys regularly for security
  • Monitor usage in your dashboard

​
Step 2: Make your first API call

Use this cURL command to generate your first image:
curl -X POST https://firemoon.studio/api/v1/flux/dev \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A beautiful sunset over mountains",
    "num_images": 1,
    "image_size": "landscape_4_3",
    "guidance_scale": 3.5
  }'
Replace YOUR_API_KEY with the key you received from us.
Create a short video with our Kling integration:
curl -X POST https://firemoon.studio/api/v1/kling/kling-2-1-master \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A butterfly emerging from its chrysalis",
    "duration": "5",
    "aspect_ratio": "16:9"
  }'

​
Step 3: Integrate into your application

Install our SDK and start generating:
// Install: npm install @firemoon-studio/sdk
import { FiremoonStudio } from '@firemoon-studio/sdk';

const client = new FiremoonStudio({
  apiKey: process.env.FIREMOON_API_KEY
});

const result = await client.generate.image({
  provider: 'flux',
  model: 'dev',
  prompt: 'A serene mountain landscape',
  num_images: 1
});

console.log('Generated image:', result.images[0].url);
Use our Python client library:
# Install: pip install firemoon-studio
from firemoon_studio import FiremoonStudio

client = FiremoonStudio(api_key=os.getenv('FIREMOON_API_KEY'))

result = client.generate.image(
    provider='flux',
    model='dev',
    prompt='A beautiful ocean sunset',
    num_images=1
)

print(f"Generated image: {result['images'][0]['url']}")

​
Response format

All generation endpoints return a consistent response: 
{
  "images": [
    {
      "url": "https://blob.vercel-storage.com/...",
      "width": 1024,
      "height": 768,
      "content_type": "image/jpeg"
    }
  ],
  "seed": 123456789,
  "has_nsfw_concepts": [false],
  "timings": {
    "inference": 2.5
  }
}

​
Rate limits & pricing

  • Free tier: 100 requests/day
  • Pro tier: 10,000 requests/month
  • Enterprise: Custom limits available
Rate limit information is included in response headers. See our rate limiting guide for details.

​
Next steps

Now that you’ve made your first API call, explore:

API Reference

Complete API documentation with all endpoints.

Provider Guides

Learn about FLUX, Ideogram, Kling, and other providers.

Authentication

Best practices for API key management.

Error Handling

Handle errors and edge cases gracefully.
Need help? Contact us at contact@firemoon.studio or join our Discord community.