GoodTake AI Docs

Welcome to GoodTake AI

GoodTake AI gives you programmatic access to the best image generation models — GPT Image, ByteDance Seedream, and Google Gemini — through a single unified API.

Base URL: https://api.goodtake.ai/v1

Quick start

# 1. Get an API key at goodtake.ai → Settings → Developer Settings

# 2. Generate your first image (synchronous, returns URLs inline)
curl -s -X POST "https://api.goodtake.ai/v1/image/generate?wait=true" \
  -H "Authorization: Bearer $GOODTAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model_identifier":"gpt-image-2","prompt":"a red fox in snow","params":{"quality":"high"}}' \
  | jq '.images[].url'

Explore the docs

Authentication

API keys, security best practices, and how keys are scoped

Image API

Generate, poll, stream — full REST reference

CLI

Install gt and generate images from your terminal

MCP & Claude

Connect GoodTake to Claude.ai or Claude Code via MCP

Endpoint overview

Method	Path	Description
`GET`	`/v1/models?type=image`	List enabled models with cost and supported params
`POST`	`/v1/image/generate`	Create a generation (async by default; `?wait=true` for sync)
`GET`	`/v1/image/generations/{id}`	Poll status and get signed image URLs
`GET`	`/v1/image/generations/{id}/stream`	Server-Sent Events stream
`GET`	`/v1/image/generations`	List your org's generations (paginated)

All API keys start with gt_. The same key works in the REST API, CLI, and MCP server.