Gemini protocol - image generation

curl --request POST \
  --url https://api.tikway.ai/v1beta/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "responseFormat": {
      "image": {
        "aspectRatio": "1:1",
        "imageSize": "1K"
      }
    }
  }
}
'

import requests

url = "https://api.tikway.ai/v1beta/models/{model}:generateContent"

payload = {
    "contents": [
        {
            "role": "user",
            "parts": [{ "text": "Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field." }]
        }
    ],
    "generationConfig": {
        "responseModalities": ["IMAGE"],
        "responseFormat": { "image": {
                "aspectRatio": "1:1",
                "imageSize": "1K"
            } }
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    contents: [
      {
        role: 'user',
        parts: [
          {
            text: 'Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field.'
          }
        ]
      }
    ],
    generationConfig: {
      responseModalities: ['IMAGE'],
      responseFormat: {image: {aspectRatio: '1:1', imageSize: '1K'}}
    }
  })
};

fetch('https://api.tikway.ai/v1beta/models/{model}:generateContent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tikway.ai/v1beta/models/{model}:generateContent",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'contents' => [
        [
                'role' => 'user',
                'parts' => [
                                [
                                                                'text' => 'Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field.'
                                ]
                ]
        ]
    ],
    'generationConfig' => [
        'responseModalities' => [
                'IMAGE'
        ],
        'responseFormat' => [
                'image' => [
                                'aspectRatio' => '1:1',
                                'imageSize' => '1K'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tikway.ai/v1beta/models/{model}:generateContent"

	payload := strings.NewReader("{\n  \"contents\": [\n    {\n      \"role\": \"user\",\n      \"parts\": [\n        {\n          \"text\": \"Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field.\"\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"responseFormat\": {\n      \"image\": {\n        \"aspectRatio\": \"1:1\",\n        \"imageSize\": \"1K\"\n      }\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tikway.ai/v1beta/models/{model}:generateContent")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"contents\": [\n    {\n      \"role\": \"user\",\n      \"parts\": [\n        {\n          \"text\": \"Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field.\"\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"responseFormat\": {\n      \"image\": {\n        \"aspectRatio\": \"1:1\",\n        \"imageSize\": \"1K\"\n      }\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tikway.ai/v1beta/models/{model}:generateContent")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"contents\": [\n    {\n      \"role\": \"user\",\n      \"parts\": [\n        {\n          \"text\": \"Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field.\"\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"responseFormat\": {\n      \"image\": {\n        \"aspectRatio\": \"1:1\",\n        \"imageSize\": \"1K\"\n      }\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "<Base64 string of generated image>"
            }
          }
        ]
      },
      "finishReason": "STOP"
    }
  ]
}

POST

https://api.tikway.ai

v1beta

models

{model}

:generateContent

Gemini protocol - image generation

curl --request POST \
  --url https://api.tikway.ai/v1beta/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "responseFormat": {
      "image": {
        "aspectRatio": "1:1",
        "imageSize": "1K"
      }
    }
  }
}
'

import requests

url = "https://api.tikway.ai/v1beta/models/{model}:generateContent"

payload = {
    "contents": [
        {
            "role": "user",
            "parts": [{ "text": "Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field." }]
        }
    ],
    "generationConfig": {
        "responseModalities": ["IMAGE"],
        "responseFormat": { "image": {
                "aspectRatio": "1:1",
                "imageSize": "1K"
            } }
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    contents: [
      {
        role: 'user',
        parts: [
          {
            text: 'Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field.'
          }
        ]
      }
    ],
    generationConfig: {
      responseModalities: ['IMAGE'],
      responseFormat: {image: {aspectRatio: '1:1', imageSize: '1K'}}
    }
  })
};

fetch('https://api.tikway.ai/v1beta/models/{model}:generateContent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tikway.ai/v1beta/models/{model}:generateContent",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'contents' => [
        [
                'role' => 'user',
                'parts' => [
                                [
                                                                'text' => 'Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field.'
                                ]
                ]
        ]
    ],
    'generationConfig' => [
        'responseModalities' => [
                'IMAGE'
        ],
        'responseFormat' => [
                'image' => [
                                'aspectRatio' => '1:1',
                                'imageSize' => '1K'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tikway.ai/v1beta/models/{model}:generateContent"

	payload := strings.NewReader("{\n  \"contents\": [\n    {\n      \"role\": \"user\",\n      \"parts\": [\n        {\n          \"text\": \"Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field.\"\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"responseFormat\": {\n      \"image\": {\n        \"aspectRatio\": \"1:1\",\n        \"imageSize\": \"1K\"\n      }\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tikway.ai/v1beta/models/{model}:generateContent")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"contents\": [\n    {\n      \"role\": \"user\",\n      \"parts\": [\n        {\n          \"text\": \"Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field.\"\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"responseFormat\": {\n      \"image\": {\n        \"aspectRatio\": \"1:1\",\n        \"imageSize\": \"1K\"\n      }\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tikway.ai/v1beta/models/{model}:generateContent")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"contents\": [\n    {\n      \"role\": \"user\",\n      \"parts\": [\n        {\n          \"text\": \"Generate a photorealistic red apple resting on a rustic wooden table, soft window light, shallow depth of field.\"\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"responseFormat\": {\n      \"image\": {\n        \"aspectRatio\": \"1:1\",\n        \"imageSize\": \"1K\"\n      }\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "<Base64 string of generated image>"
            }
          }
        ]
      },
      "finishReason": "STOP"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

model

string

required

Body

application/json

contents

object[]

required

Required. Plain text is for image editing; text plus inlineData is for image editing.

Minimum array length: 1

Hide child attributes

contents.parts

object[]

required

Minimum array length: 1

Hide child attributes

contents.parts.text

string

Prompt words for generating or editing images.

contents.parts.inlineData

object

Base64 reference image used when editing.

Hide child attributes

contents.parts.inlineData.mimeType

string

required

Image MIME type, such as image/png.

contents.parts.inlineData.data

string

required

Base64 image content without the data URL prefix.

contents.role

enum<string>

Usually user or omitted.

Available options:

user,

model

generationConfig

object

Nano Banana image output configuration.

Hide child attributes

generationConfig.responseModalities

enum<string>[]

Set to ["IMAGE"] when returning only images.

Available options:

TEXT,

IMAGE

generationConfig.responseFormat

object

Hide child attributes

generationConfig.responseFormat.image

object

Hide child attributes

generationConfig.responseFormat.image.aspectRatio

enum<string>

Target aspect ratio; available range varies by model.

Available options:

1:1,

1:4,

1:8,

2:3,

3:2,

3:4,

4:1,

4:3,

4:5,

5:4,

8:1,

9:16,

16:9,

21:9

generationConfig.responseFormat.image.imageSize

enum<string>

Target resolution; available range varies by model.

Available options:

0.5K,

1K,

2K,

4K

Response

200 - application/json

candidates

object[]

required

Hide child attributes

candidates.content

object

required

Hide child attributes

candidates.content.parts

object[]

required

Hide child attributes

candidates.content.parts.text

string

candidates.content.parts.inlineData

object

Hide child attributes

candidates.content.parts.inlineData.mimeType

string

required

candidates.content.parts.inlineData.data

string

required

candidates.finishReason

string

usageMetadata

object

Chat completions

Image generation

Video generation

Embeddings

Transcriptions

Gemini protocol - image generation

Authorizations

Path Parameters

Body

Response