> ## Documentation Index > Fetch the complete documentation index at: https://docs.creatorline.io/llms.txt > Use this file to discover all available pages before exploring further. # Start an upload > Uploads are two-step and the bytes never pass through this API: 1. `POST /v1/uploads` → a short-lived presigned `PUT` and the asset id it will become 2. `PUT` the bytes to `upload_url` with the returned headers 3. `POST /v1/uploads/{id}/complete` → the asset is ready to use as a generation input Limits: images 25 MB, video 100 MB, audio 50 MB. ## OpenAPI ````yaml /openapi.json post /v1/uploads openapi: 3.1.0 info: title: Creatorline API version: 1.0.0 description: >- Generate AI influencer photos and videos, and publish them to your creators' social accounts — from your own backend, your scripts, or a coding agent. Every request authenticates with an organization-scoped API key and is charged against that organization's credits, at the same prices the studio shows. servers: - url: https://api.creatorline.io description: Production - url: http://localhost:3000/api description: Local development (the same routes, under the app's own /api prefix) security: - bearerAuth: [] - apiKeyHeader: [] tags: - name: Account description: Who the key belongs to, and what it can spend. - name: Catalog description: The live tool and model catalog. Read it, do not hardcode it. - name: Creators description: The AI creators a generation or post belongs to. - name: Generations description: Start, price and poll image and video runs. - name: Assets description: The media library, and uploading your own files. - name: Posts description: Turn media into a post and publish it to social platforms. - name: Credits description: Balance and the consumption ledger. paths: /v1/uploads: post: tags: - Assets summary: Start an upload description: >- Uploads are two-step and the bytes never pass through this API: 1. `POST /v1/uploads` → a short-lived presigned `PUT` and the asset id it will become 2. `PUT` the bytes to `upload_url` with the returned headers 3. `POST /v1/uploads/{id}/complete` → the asset is ready to use as a generation input Limits: images 25 MB, video 100 MB, audio 50 MB. operationId: createUpload requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateUploadRequest' example: content_type: image/png size_bytes: 482113 filename: face.png responses: '200': description: The presigned upload. headers: x-request-id: description: >- Correlation id for this request. Quote it in any support question. schema: type: string x-ratelimit-limit: description: Requests allowed per minute. schema: type: integer x-ratelimit-remaining: description: Requests left in the current window. schema: type: integer x-ratelimit-reset: description: Unix seconds when the window resets. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Upload' '400': description: Invalid request. `param` names the offending field. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request_error code: invalid_parameter message: '`content_type` is required (e.g. image/png).' param: content_type request_id: req_8fQ2mRxK1pLd '401': description: Missing, malformed, revoked or expired key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: authentication_error code: invalid_api_key message: Missing or invalid API key. request_id: req_8fQ2mRxK1pLd '403': description: The key exists but may not do this (read-only key). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: permission_error code: insufficient_scope message: >- This API key is read-only. Create a key with the `write` scope to run generations. request_id: req_8fQ2mRxK1pLd '404': description: No such resource — including one that belongs to another workspace. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: not_found_error code: resource_missing message: No such generation. request_id: req_8fQ2mRxK1pLd components: schemas: CreateUploadRequest: type: object properties: content_type: type: string description: e.g. image/png, video/mp4, audio/mpeg. size_bytes: type: number filename: type: string ext: type: string description: Overrides the extension derived from `filename`. account_id: type: string format: uuid required: - content_type - size_bytes Upload: type: object properties: object: type: string enum: - upload asset_id: type: string format: uuid upload_url: type: string format: uri method: type: string enum: - PUT headers: type: object additionalProperties: type: string expires_in: type: number description: Seconds. complete_url: type: string Error: type: object description: >- Every failure has this shape. `param` names the offending field when there is one. properties: error: type: object properties: type: type: string enum: - invalid_request_error - authentication_error - permission_error - not_found_error - rate_limit_error - insufficient_credits_error - api_error code: type: string message: type: string param: type: string required: - type - code - message request_id: type: string required_credits: type: number description: 402 only. credit_balance: type: number description: 402 only. required: - error - request_id securitySchemes: bearerAuth: type: http scheme: bearer description: >- Your organization's API key, from Settings → API. `Authorization: Bearer crl_sk_live_…` apiKeyHeader: type: apiKey in: header name: X-API-Key description: Alternative to the Authorization header, for tooling that prefers it. ```` ## Related topics - [Finish an upload](/api-reference/assets/finish-an-upload.md) - [Generating media](/generations.md) - [Creatorline API](/index.md) - [CLI](/cli.md) - [Publishing](/publishing.md)