API Reference

Proxy Endpoint

The core endpoint for executing AI wrappers. Send your prompt and optional overrides, and receive perfectly structured JSON in return.

Authentication

Authenticate your API requests by including your secret API key in the Authorization header.

Authorization: Bearer zw_live_xxxxxxxxxxxxxxxxxxxx

The Endpoint

POSThttps://api.zywrap.com/v1/proxy

Request Body

Parameters

wrapperCodesarray of stringsREQUIRED

An array of wrapper codes to execute. If multiple are provided, they will be executed sequentially as a chain.

variablesobjectOPTIONAL

A key-value dictionary of dynamic inputs required by the specific wrapper's schema (e.g., pageTopic, primaryKeyword).

promptstringOPTIONAL

Your input text, additional context, or unstructured instructions to be processed by the wrapper(s).

modelstringOPTIONAL

The specific AI model code to use (e.g., 'openai-gpt-5.4'). If omitted, the platform default is used.

toneCodestringOPTIONAL

Override the wrapper's default tone.

styleCodestringOPTIONAL

Override the wrapper's default writing style.

formatCodestringOPTIONAL

Override the wrapper's default output formatting.

complexityCodestringOPTIONAL

Override the wrapper's default complexity level.

lengthCodestringOPTIONAL

Override the wrapper's default target length.

audienceCodestringOPTIONAL

Override the wrapper's target audience level.

responseGoalCodestringOPTIONAL

Override the wrapper's default response goal.

outputCodestringOPTIONAL

Override the wrapper's default output type format.

Code Examples

bash

curl -X POST https://api.zywrap.com/v1/proxy \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai-gpt-5.4",
    "wrapperCodes": ["mc_seo_meta_titles_descriptions_base"],
    "prompt": "Keep the tone very professional.",
    "variables": {
      "pageTopic": "AI project management software",
      "primaryKeyword": "agency project management"
    }
  }'

javascript

import axios from 'axios';

const response = await axios.post(
  'https://api.zywrap.com/v1/proxy',
  {
    model: 'openai-gpt-5.4',
    wrapperCodes: ['mc_seo_meta_titles_descriptions_base'],
    prompt: 'Keep the tone very professional.',
    variables: {
      pageTopic: 'AI project management software',
      primaryKeyword: 'agency project management'
    }
  },
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

console.log(response.data);