Process images using the OpenAI SDK client.images.edit() method. The model parameter determines which AI processing is applied. Use extra_body for model-specific fields that are not part of the standard OpenAI image edit signature.

Setup

from openai import OpenAI
client = OpenAI(api_key='sk-snap-xxx', base_url='https://api.snapedit.app/v1')

Supported Models

Removal

Enhance & Restore Images

Generation from Image

Style-based (prompt = style_id)

Detection (returns JSON, not image)

Utility

Examples

Remove background:

result = client.images.edit(
    model='snapedit/remove-bg',
    image=open('photo.png', 'rb'),
    prompt=''
)
print(result.data[0].url)

Enhance 4x:

result = client.images.edit(
    model='snapedit/enhance-4x',
    image=open('photo.png', 'rb'),
    prompt=''
)

Headshot generation:

result = client.images.edit(
    model='snapedit/headshot',
    image=open('face.png', 'rb'),
    prompt='Professional studio headshot with soft lighting'
)

Hairstyle (prompt = style_id):

result = client.images.edit(
    model='snapedit/hairstyle',
    image=open('face.png', 'rb'),
    prompt='bobcut'  # style_id from styles list
)

Pose suggest (extra params via extra_body):

result = client.images.edit(
    model='snapedit/pose-suggest',
    image=open('scene.png', 'rb'),
    prompt='',
    extra_body={'num_models': 3, 'gender': 'female'}
)

Multi-image edit (extra images via extra_body):

result = client.images.edit(
    model='snapedit/qwen-edit-multi',
    image=open('img1.png', 'rb'),
    prompt='Combine the two people in a park',
    extra_body={'input_image_1': 'https://example.com/img2.png'}
)

Detect objects (returns JSON):

result = client.images.edit(
    model='snapedit/detect-objects',
    image=open('photo.png', 'rb'),
    prompt=''
)
print(result.model_dump())  # raw detection JSON