Skip to main content

​
Tool: refine_slide

Refine an existing slide based on instructions. Useful for making adjustments to individual slides without regenerating the entire presentation.

​
Parameters

ParameterTypeRequiredDescription
slide_idstringYesUUID of the slide to refine
instructionsstringYesRefinement instructions
layout_namestringNoSpecific layout to use
conversation_idstringNoExisting conversation UUID

​
Example Request

{
  "method": "tools/call",
  "params": {
    "name": "refine_slide",
    "arguments": {
      "slide_id": "uuid",
      "instructions": "Make the title more engaging and add bullet points for key features",
      "layout_name": "Content Slide",
      "conversation_id": "uuid"
    }
  }
}

​
Response

{
  "slide": {
    "slide_id": "uuid",
    "slide_number": 3,
    "layout": "Content Slide",
    "content": {
      "title": "Enhanced Title",
      "bullets": [
        "Key feature 1",
        "Key feature 2",
        "Key feature 3"
      ]
    },
    "thumbnail_url": "https://...",
    "download_url": "https://...",
    "web_url": "https://..."
  },
  "reflection": "Refined the slide to be more engaging..."
}

​
Use Cases

  • Content Adjustments: Modify text, add or remove content
  • Layout Changes: Switch to a different layout within the same template
  • Style Updates: Adjust formatting or styling
  • Iterative Refinement: Make multiple passes to perfect a slide

​
Python Example

import requests

API_KEY = "pk_your_api_key_here"
BASE_URL = "https://poe.poesius.com/api/v1/mcp"

def refine_slide(slide_id, instructions, layout_name=None, conversation_id=None):
    arguments = {
        "slide_id": slide_id,
        "instructions": instructions
    }
    
    if layout_name:
        arguments["layout_name"] = layout_name
    
    if conversation_id:
        arguments["conversation_id"] = conversation_id
    
    response = requests.post(
        f"{BASE_URL}/messages",
        headers={
            "X-API-Key": API_KEY,
            "Content-Type": "application/json"
        },
        json={
            "method": "tools/call",
            "params": {
                "name": "refine_slide",
                "arguments": arguments
            }
        }
    )
    return response.json()

# Refine a slide
result = refine_slide(
    slide_id="uuid",
    instructions="Make the content more concise and add a call-to-action",
    layout_name="Content Slide"
)

print(f"Refined slide: {result['result']['slide']['slide_number']}")
print(f"Download URL: {result['result']['slide']['download_url']}")

​
Best Practices

  • Be Specific: Provide clear, specific instructions for what you want changed
  • Layout Selection: Specify layout_name if you want to change the layout
  • Iterative Process: Refine slides multiple times to achieve the desired result
  • Conversation Context: Use conversation_id to maintain context across refinements

Generate Slides

Learn about generating new slides

Two-Step Process

Learn about the two-step generation process