API Reference

Complete reference documentation for the Deep Creative Labs API.

Base URL

https://api.deepcreativelabs.com/v1

Authentication

All API requests require a valid API key in the Authorization header:

Header

Authorization: Bearer YOUR_API_KEY

Request Format

• All requests must include Content-Type: application/json

• Request bodies should be valid JSON

• Dates are in ISO 8601 format (2025-01-15T10:30:00Z)

Endpoints

Predictions

Create and manage AI predictions

POST /v1/:owner/:model/predictionsGET /v1/predictions/:idGET /v1/predictions/:id/streamPOST /v1/predictions/:id/cancel

Batch Predictions

Create and track multiple predictions

POST /v1/predictions/batchGET /v1/predictions/batch/:id

Models

Browse and get info about available models

GET /v1/modelsGET /v1/models/:id

Files

Upload and manage files

POST /v1/filesGET /v1/filesGET /v1/files/:idDELETE /v1/files/:id

Webhooks

Set up webhook notifications

POST /v1/webhooksGET /v1/webhooks

Account

Get account info, balance, and usage

GET /v1/accountGET /v1/account/balanceGET /v1/account/usageGET /v1/account/rate-limits

API Keys

Manage API keys

GET /v1/api-keysPOST /v1/api-keysDELETE /v1/api-keys/:idPOST /v1/api-keys/:id/rotate

Utilities

Health check, cost estimation, search

GET /v1/healthPOST /v1/estimateGET /v1/search

Response Format

All responses return JSON. Successful responses include the requested data, while errors follow a consistent error format.

Success Response

{
  "job_id": "pred_abc123",
  "status": "succeeded",
  "output": [...],
  ...
}

Error Response

{
  "error": {
    "type": "invalid_request_error",
    "message": "...",
    "code": "ERROR_CODE"
  }
}

Pagination

List endpoints support cursor-based pagination:

Parameter	Description
limit	Number of items per page (default: 25, max: 100)
cursor	Cursor for next page (from previous response)