POST /v1/videos/:video_id/remix

{
  "id": "video_xyz789",
  "object": "video",
  "created": 1730638000,
  "model": "sora-2",
  "prompt": "Activists celebrating victory at city hall",
  "status": "queued",
  "progress": 0,
  "seconds": "8",
  "size": "1280x720",
  "url": null,
  "x-cost": {
    "amount": 2.50,
    "currency": "USD"
  },
  "x-remixed-from": "video_abc123"
}

async function createVariations(
  sourceVideoId: string,
  prompts: string[]
): Promise<Video[]> {
  const remixes: Video[] = [];

  for (const prompt of prompts) {
    const response = await fetch(
      `https://api.outcryai.com/v1/videos/${sourceVideoId}/remix`,
      {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${process.env.OUTCRY_API_KEY}`,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify({ prompt })
      }
    );

    const remix = await response.json();
    remixes.push(remix);

    console.log(`Created remix: ${remix.id} - "${prompt}"`);

    // Wait to avoid rate limits
    await new Promise(resolve => setTimeout(resolve, 1000));
  }

  return remixes;
}

const variations = await createVariations('video_abc123', [
  'Activists marching with banners',
  'Activists speaking at rally',
  'Activists organizing community meeting',
  'Activists celebrating victory'
]);

console.log(`Created ${variations.length} variations`);

async function iterateOnPrompt(
  initialPrompt: string,
  refinements: string[]
): Promise<Video[]> {
  // Create initial video
  const initial = await client.videos.create({
    model: 'sora-2',
    prompt: initialPrompt,
    seconds: '8',
    size: '1280x720'
  });

  console.log(`Initial: ${initial.id}`);

  // Wait for completion
  let current = await waitForVideo(initial.id);

  const videos = [current];

  // Create refinements as remixes
  for (const refinedPrompt of refinements) {
    const response = await fetch(
      `https://api.outcryai.com/v1/videos/${current.id}/remix`,
      {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${process.env.OUTCRY_API_KEY}`,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify({ prompt: refinedPrompt })
      }
    );

    current = await response.json();
    current = await waitForVideo(current.id);

    videos.push(current);

    console.log(`Refined: ${current.id} - "${refinedPrompt}"`);
  }

  return videos;
}

const iterations = await iterateOnPrompt(
  'Climate protest at city hall',
  [
    'Climate protest with large crowd at city hall',
    'Climate protest with diverse activists and banners at city hall',
    'Powerful climate protest with thousands of activists at city hall'
  ]
);

// Original video: sora-2, 8s, 1280x720 = $2.50
const original = await client.videos.retrieve('video_abc123');

// Remix: same settings = same cost ($2.50)
const remix = await fetch(
  `https://api.outcryai.com/v1/videos/${original.id}/remix`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.OUTCRY_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      prompt: 'New variation'
    })
  }
).then(r => r.json());

// Both cost $2.50 each

{
  "error": {
    "type": "invalid_request_error",
    "message": "Source video not found: video_abc123",
    "code": "video_not_found"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "message": "prompt must be 10-500 characters",
    "param": "prompt",
    "code": "invalid_prompt"
  }
}

function validatePrompt(prompt: string): void {
  if (prompt.length < 10) {
    throw new Error('Prompt must be at least 10 characters');
  }
  if (prompt.length > 500) {
    throw new Error('Prompt must be less than 500 characters');
  }
}

{
  "error": {
    "type": "insufficient_quota",
    "message": "Insufficient prepaid balance. Required: $2.50, Available: $1.25",
    "code": "insufficient_quota"
  }
}

async function getRemixChain(videoId: string): Promise<Video[]> {
  const chain: Video[] = [];
  let currentId: string | null = videoId;

  while (currentId) {
    const video = await client.videos.retrieve(currentId);
    chain.unshift(video);  // Add to beginning

    // Check if this is a remix
    currentId = video['x-remixed-from'] || null;
  }

  return chain;
}

const chain = await getRemixChain('video_xyz789');

console.log('Remix chain:');
for (let i = 0; i < chain.length; i++) {
  console.log(`${i + 1}. ${chain[i].id} - "${chain[i].prompt}"`);
}

// Output:
// 1. video_abc123 - "Climate protest"
// 2. video_def456 - "Climate protest with large crowd"
// 3. video_xyz789 - "Powerful climate protest with thousands"