AI Fashion API: the OpenAPI 3.1 Document
An API that an AI agent can read on its own is a different kind of API. The New Black AI publishes its whole interface as a public OpenAPI 3.1 document, generated the instant you request it, so a code generator, a coding agent or a developer gets the exact contract of every route and every fashion workflow.
Updated 20 September 2026
- 1Open the document
- 2Generate a client or hand it to an agent
- 3Call the routes with an API key
How it works
Open the document
https://thenewblack.ai/api/v1/openapi.json, public, no account needed to read it.
Generate a client or hand it to an agent
A typed client in your language from the URL; or let Claude Code, Codex or Cursor read it and call the API correctly.
Call the routes with an API key
Keys are created in your profile, API tab; each workflow is its own schema of POST /v1/generate.
Why it matters
The studio has dozens of workflows, each with its own inputs. Describing them one by one in a machine-readable document, regenerated on each read, means a route added on the platform is in the document immediately and nobody integrates against a stale spec.
Read more in AI Fashion API as an OpenAPI 3.1 document. The reference lives on the API and integrations page.
Frequently asked questions
Do I need an account to read it?+
No. You need an API key to call the routes it describes.
Are the generation workflows described?+
Yes, each as its own schema of POST /v1/generate with the inputs it accepts.
Can I pause my plan and keep my API key?+
Yes. A plan can be paused one to three months; the account and its keys stay, and the credits you have remain usable.
Try it yourself
Everything on this page was made in the studio. Your first designs are minutes away.
Open the studioRelated features
- Shopify Product Page Optimization ScoreEach Shopify product gets a score for how well its page is optimised: photos, videos, description, SEO fields. Open the score to see what is missing and fix it from the studio.
- Shopify Product Performance: Traffic, Add-to-Cart and ConversionA pixel you enable in one click on Shopify feeds your Store page with traffic, add-to-cart rate and conversion rate per product, combined with sales into one performance score.
- Shopify Sales Next to Your VisualsIn the studio's Shopify view, each product's Performance tile reads your store's sales: enable it once and the creations you make for a product sit next to what that product sells.
- AI Blog Writer for Shopify StoresFrom the Store page, SEO tab: give a brief, get a draft article or page, edit it, and save it to Shopify as a draft you publish yourself, written next to the Search Console queries it should answer.
- Shopify Sales Channels per ProductEach product on your Store page shows on how many sales channels it is sold. Click the number to put it on Online Store, Shop, Instagram, Google, or take it off. The change is written to Shopify.
- Create Shopify Products from the StudioIn the studio's Shopify view, a Create a product button asks for a title and creates the product in your store, then the visuals you generate publish straight to its page.
- Publish AI Visuals to Shopify Product PagesOpen a creation, choose the product, and the image or video lands on its Shopify product page. Unpublish from the same tab. Also available from the API with the publish scope.
- Social Media Agenda for Fashion BrandsA week agenda in your Store with a row per network: Instagram, Facebook, Threads, Pinterest, X, YouTube and TikTok. Schedule creations or your own files; existing posts appear on their day.