CartViral

CartViral Photos API

The Photos API from CartViral — 1 operation(s) for photos.

GitHub OpenAPI

Operations 2

POST /photos Queue an AI photo set of a product #
GET /photos Photo sets with render status and download links #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/cartviral-com/openapi/cartviral-com-photos-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/cartviral-com:cartviral-com-photos-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cartviral-com-photos-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: CartViral Photos API
  version: 1.0.0
  description: 'AI product videos for e-commerce: import products, generate TikTok, Reels and Shorts clips, get download links, and work with the CartViral Earn creator marketplace. Same operations as the MCP server at https://app.cartviral.com/mcp. Docs: https://cartviral.com/api'
  contact:
    name: CartViral
    email: support@cartviral.com
    url: https://cartviral.com
servers:
- url: https://app.cartviral.com/api/v1
security:
- bearer: []
- oauth:
  - mcp
tags:
- name: Photos
paths:
  /photos:
    post:
      operationId: generatePhotos
      summary: Queue an AI photo set of a product
      description: 'Queue a set of AI photos for one catalog product. Formats and credit cost: photo_model (9, a photoshoot with an AI model wearing or using the product), photo_product (8, clean studio and lifestyle product shots), photo_infographic (7, a labelled infographic built only from the product''s real facts, needs enough facts on the product page). A set renders in a few minutes; every image comes in a square (2000x2000) and a portrait (1080x1350) size, plus a zip of the whole set. Credits are charged from the account; a failed set refunds automatically. Poll list_photo_sets for download links.'
      x-openai-isConsequential: true
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: Invalid input or the action could not be done; body has an error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid credentials
        '429':
          description: 'Rate limit: 120 calls per minute per key'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                product_id:
                  type: string
                  description: Product id from list_products
                format:
                  type: string
                  enum:
                  - photo_model
                  - photo_tryon
                  - photo_product
                  - photo_infographic
              required:
              - product_id
              - format
      tags:
      - Photos
    get:
      operationId: listPhotoSets
      summary: Photo sets with render status and download links
      description: Recent AI photo sets of the account's catalog, newest first, with render status and, when done, a zip download link and each image's view/download links (square 2000x2000 and portrait 1080x1350).
      x-openai-isConsequential: false
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 50
          default: 12
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: Invalid input or the action could not be done; body has an error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid credentials
        '429':
          description: 'Rate limit: 120 calls per minute per key'
      tags:
      - Photos
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
      required:
      - error
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: API key from Account → AI agents (cv_live_...), or an OAuth access token
    oauth:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://app.cartviral.com/oauth/authorize
          tokenUrl: https://app.cartviral.com/oauth/token
          refreshUrl: https://app.cartviral.com/oauth/token
          scopes:
            mcp: Use your CartViral account