Skip to main content
This walks you through the typical generation flow end-to-end: authenticate, pick a model, estimate cost, generate, and retrieve results.

​
1. Get your API token

  1. Log in to app.layer.ai
  2. Go to Settings > Personal Access Tokens
  3. Click Create Token, name it, and copy the value
Export it for the examples below: 
export LAYER_TOKEN="your-pat-token"
export WORKSPACE_ID="your-workspace-id"

​
2. Pick a model

List models and choose one that fits your use case: 
curl https://api.app.layer.ai/api/v1/workspaces/$WORKSPACE_ID/models \
  -H "Authorization: Bearer $LAYER_TOKEN"
Note the id of the model you want to use.

​
3. Estimate cost

Check how many Creative Units the generation will consume: 
curl -X POST https://api.app.layer.ai/api/v1/workspaces/$WORKSPACE_ID/inferences/estimate \
  -H "Authorization: Bearer $LAYER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": "MODEL_ID",
    "parameters": {
      "prompt": "A medieval castle on a hilltop at sunset, game concept art",
      "width": 1024,
      "height": 1024
    }
  }'

​
4. Generate

curl -X POST https://api.app.layer.ai/api/v1/workspaces/$WORKSPACE_ID/inferences \
  -H "Authorization: Bearer $LAYER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": "MODEL_ID",
    "parameters": {
      "prompt": "A medieval castle on a hilltop at sunset, game concept art",
      "width": 1024,
      "height": 1024
    }
  }'
This returns immediately with an inference_id and status: "IN_PROGRESS".

​
5. Poll for results

curl https://api.app.layer.ai/api/v1/workspaces/$WORKSPACE_ID/inferences/INFERENCE_ID \
  -H "Authorization: Bearer $LAYER_TOKEN"
When status is COMPLETED, the response includes URLs to your generated assets.

​
Next steps

  • Browse the API reference for full endpoint details and parameter documentation
  • Upload reference images to guide generation with your own art style
  • Use workflows to run multi-step pipelines