New

Free Email Tester is Live

Real-time open & click tracking - No setup required

← Back to Creator Paradise
Developer Reference

Creator Paradise API Guide

Render professional social media images programmatically. One HTTP request returns a pixel-perfect PNG -ready to publish, embed, or store.

Getting Access

API keys are prefixed od2_cc_. Keep your key private -do not expose it in public client-side code or public repositories. Each key carries a rate limit assigned by the admin.

Endpoint

All render requests are made as a single GET to the following URL. Replace :category with the content category (e.g. Quotes, News, Blog).

HTTP
GET https://od2.in/content-creator-paradise/api/create/image/:category

Authentication -three options

BASH
1# Option A -query parameter (simplest)2GET /api/create/image/Quotes?secret=od2_cc_YOUR_KEY&...3
4# Option B -request header5GET /api/create/image/Quotes?...6X-Api-Key: od2_cc_YOUR_KEY7
8# Option C -Bearer token9GET /api/create/image/Quotes?...10Authorization: Bearer od2_cc_YOUR_KEY

Full example request

HTTP
1GET /content-creator-paradise/api/create/image/Quotes2    ?secret=od2_cc_YOUR_KEY3    &template=torn-paper4    &size=1080x13505    &quote=Your only limit is your mind.6    &author=Marcus Aurelius7    &brand=OD2 Quotes8    &hashtags=#motivation, #focus9    &showLogo=true10    &showBrand=true11    &showAuthor=true12    &showHashtags=true
The response is a raw image/png stream. Use the URL directly as an <img src>, pass it to the Facebook Graph API /photos?url=, or download and store it -no conversion needed.

Query Parameters

ParameterTypeRequiredDescription
secretstringYesYour API secret key. Can also be sent as X-Api-Key header or Authorization: Bearer token.
templatestringYesTemplate ID to render. e.g. torn-paper, raw-editorial, minimal-gradient, bold-overlay.
sizestringYesOutput resolution in WxH format. e.g. 1080x1350 (portrait), 1080x1080 (square), 1080x576 (landscape).
quotestringYesMain post text. URL-encode the value. Auto line-breaks and font-scales to fit the canvas.
authorstringNoAuthor or attribution name shown below the quote.
brandstringNoBrand footer text. Supports {{brand.name}} placeholder.
hashtagsstringNoComma-separated hashtags. e.g. #motivation,%20#focus.
logoURLNoPublic URL to your logo image (PNG or JPG). Drawn on the canvas client-side.
imageURLNoBackground image URL.
brandNamestringNoOverride brand name per request.
logoUrlURLNoAlias for logo -override per request.
authorNamestringNoOverride author per request.
handlestringNoSocial handle. e.g. @onedaydevelopers.
websitestringNoWebsite domain shown in template footer.
sloganstringNoBrand slogan text.
showLogobooleanNotrue / false -toggle logo visibility.
showBrandbooleanNotrue / false -toggle brand footer.
showAuthorbooleanNotrue / false -toggle author name.
showHashtagsbooleanNotrue / false -toggle hashtag block.
showCategorybooleanNotrue / false -toggle category label.

Templates & Sizes

Available Templates

torn-paper

Textured editorial

Quotes
raw-editorial

Clean, minimal

Any
minimal-gradient

Smooth gradient

Brand
bold-overlay

High-contrast overlay

News

More templates are added regularly. Visit the Template Browser to see all current options.

Supported Sizes

1080 × 1350

Instagram Feed

Portrait
1080 × 1080

Standard Card

Square
576 × 1024

Reels / TikTok / Stories

Story
1080 × 576

Blog Banner / Twitter

Landscape

Rate Limits

3
Default RPM
requests per minute
Per-key
Key type
each key has its own limit
5/hr
IP throttle
for key generation (app)

When you exceed your RPM limit the API returns a 429 with a Retry-After header. Implement exponential back-off in your client. Admin-issued keys can have their limit increased -contact us.

HTTP
1HTTP/1.1 429 Too Many Requests2Retry-After: 453X-RateLimit-Limit: 34X-RateLimit-Remaining: 05Content-Type: application/json
JSON
1{2  "success": false,3  "error": "Rate limit exceeded. You are allowed 3 request(s) per minute.",4  "retryAfterSeconds": 455}

Successful responses include X-RateLimit-Limit and X-RateLimit-Remaining headers so you can track usage client-side.

Error Responses

All errors return JSON with a success: false field and a human-readable error message.

200
OKRendered PNG image stream.
400
Bad RequestMissing required parameter or invalid value.
401
UnauthorizedMissing or invalid API secret.
429
Too Many RequestsRate limit exceeded. Check Retry-After header.
500
Server ErrorInternal render engine error. Contact support.

Usage Policy

The OD2 Creator Paradise API is provided free of charge. By using it you agree to the following fair-use policy. Violations may result in immediate key revocation.

Allowed

  • Generating social media posts for your own brands or clients
  • Automating content pipelines from spreadsheets, databases, N8N or CMS data
  • Embedding the API in scheduling tools or dashboards
  • Publishing the returned image URL directly to Facebook, Instagram, or Buffer
  • Building internal tools for your team

Prohibited

  • Reselling API access or re-exporting keys to third parties
  • Generating content that promotes hate speech, violence, or illegal activities
  • Circumventing rate limits by creating multiple keys for the same use case
  • Using the API to train machine learning models without written consent
  • Automated mass abuse -more than your allocated RPM without prior arrangement
This policy may be updated at any time. We will notify active API users of material changes. The current version was last updated: June 2026.

Ready to build?

Request an API key now via the contact form, or wait for the OD2 Creator App to generate keys instantly from your phone.