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

# API Quickstart

> BizyAir API three-minute quickstart: configure API Key, call the sync task endpoint, and get results with complete curl examples.

BizyAir Model Service exposes every AI model (or AI app, workflow) as an HTTPS POST endpoint. All tasks are initiated through a unified task creation interface.

## Core Concepts

| Concept       | Description                                                              |
| ------------- | ------------------------------------------------------------------------ |
| web\_app\_id  | Unique numeric ID of the AI app or workflow                              |
| input\_values | Workflow input parameters, key format: `NodeID:NodeName.FieldName`       |
| request\_id   | Unique ID assigned per task for querying/canceling                       |
| object\_url   | Temporary hosting URL for result files                                   |
| status        | Task status: Queuing / Preparing / Running / Success / Failed / Canceled |
| API Key       | Account credential from User Center                                      |
| Balance       | Prepaid credits, deducted by actual consumption                          |

## Three-Minute Quickstart

```bash theme={null}
# 1. Set API Key (from User Center → API Keys)
export BIZYAIR_API_KEY="your-api-key-here"

# 2. Call AI app synchronously
curl -X POST "https://api.bizyair.ai/v1/webapp/task/openapi/create" \
  -H "Authorization: Bearer $BIZYAIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "web_app_id": 38214,
    "input_values": {
      "84:CLIPTextEncode.text": "a futuristic cityscape at sunset",
      "88:KSampler.seed": 354884000907176,
      "81:EmptySD3LatentImage.width": 1280,
      "81:EmptySD3LatentImage.height": 1280
    }
  }'
```