API Overview

The MakePhotos API is a REST API served at https://makephotos.ai/api/v1/.

Base URL

https://makephotos.ai/api/v1

Authentication

All requests require an API key passed as a key query parameter:

https://makephotos.ai/api/v1/credits?key=mk_live_...

Get your API key from the developer dashboard.

Endpoints

Method	Endpoint	Description
`POST`	`/api/v1/generate`	Generate an AI photo
`POST`	`/api/v1/remove-bg`	Remove image background
`GET`	`/api/v1/credits`	Check credit balance
`GET`	`/api/v1/upload/signed`	Get signed upload params
`POST`	`/api/v1/upload`	Upload an image (small files)

Response format

All successful responses return JSON:

{
  "result_url": "https://res.cloudinary.com/...",
  "credits_used": 1,
  "credits_remaining": {
    "monthly": 49,
    "topup": 10,
    "total": 59
  }
}

Error format

All errors return a consistent JSON structure:

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits. Need 2, have 1.",
    "details": {
      "monthly_remaining": 0,
      "topup_remaining": 1
    }
  }
}

See Error Codes for the full list.

Rate limiting

There are no rate limits. Credits serve as the natural throttle — each API call consumes credits from your subscription.

Content type

POST endpoints with JSON bodies expect Content-Type: application/json
POST /api/v1/upload expects multipart/form-data
GET endpoints have no request body

API Overview

On this page