## Basic model info

- Model name: kling/kling kling-o1-standard
- Model description: Generate a video by taking a start frame and an end frame, animating the transition between them while following text-driven style and scene guidance.
- Endpoint name: reference-to-video


## Model schema

The model schema is defined in the OpenAPI schema: [OpenAPI Schema](https://oapi.sunra.ai/main/kling/kling-o1-standard/latest.json)

### Model input schema

The model input schema is:



```json
{
  "description": "Input model for reference-to-video generation.",
  "properties": {
    "prompt": {
      "description": "Text prompt. Use @Element1, @Element2 for elements and @Image1, @Image2 for images.",
      "maxLength": 2500,
      "title": "Prompt",
      "type": "string",
      "x-sr-order": 201
    },
    "aspect_ratio": {
      "default": "16:9",
      "description": "Aspect ratio of the generated video",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "title": "Aspect Ratio",
      "type": "string",
      "x-sr-order": 403
    },
    "duration": {
      "default": "5",
      "description": "Duration of the video in seconds",
      "enum": [
        "3",
        "4",
        "5",
        "6",
        "7",
        "8",
        "9",
        "10"
      ],
      "title": "Duration",
      "type": "string",
      "x-sr-order": 401
    },
    "elements": {
      "anyOf": [
        {
          "items": {
            "description": "Element input for character/object reference.",
            "properties": {
              "frontal_image_url": {
                "description": "The frontal image of the element (main view). Max 10MB, min 300x300px, aspect ratio 0.40-2.50",
                "title": "Frontal Image Url",
                "type": "string"
              },
              "reference_image_urls": {
                "anyOf": [
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Additional reference images from different angles. 1-3 images supported.",
                "title": "Reference Image Urls"
              }
            },
            "required": [
              "frontal_image_url"
            ],
            "title": "ElementInput",
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Characters/objects to include. Reference as @Element1, etc. Max 7 total (elements + images + start image).",
      "title": "Elements",
      "x-sr-order": 303
    },
    "image_urls": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Additional reference images. Reference as @Image1, etc. Max 7 total (elements + images + start image).",
      "title": "Image Urls",
      "x-sr-order": 304
    }
  },
  "required": [
    "prompt"
  ],
  "title": "ReferenceToVideoInput",
  "type": "object"
}
```



### Model output schema

The model output schema is:



```json
{
  "description": "Output model with video duration for post_calculated pricing.",
  "properties": {
    "output_video_dur": {
      "description": "Duration of the output video in seconds (rounded)",
      "title": "Output Video Dur",
      "type": "integer"
    },
    "video": {
      "properties": {
        "content_type": {
          "description": "The mime type of the file.",
          "title": "Content Type",
          "type": "string"
        },
        "file_name": {
          "description": "The name of the file. It will be auto-generated if not provided.",
          "title": "File Name",
          "type": "string"
        },
        "file_size": {
          "description": "The size of the file in bytes.",
          "title": "File Size",
          "type": "integer"
        },
        "url": {
          "description": "The URL where the file can be downloaded from.",
          "title": "Url",
          "type": "string"
        }
      },
      "required": [
        "content_type",
        "file_name",
        "file_size",
        "url"
      ],
      "title": "SunraFile",
      "type": "object"
    }
  },
  "required": [
    "video",
    "output_video_dur"
  ],
  "title": "KlingVideoOutput",
  "type": "object"
}
```



## Example inputs and outputs

Use the following example inputs and outputs to understand the model.

### Input example



```json
{
  "prompt": "",
  "aspect_ratio": "16:9",
  "duration": "5",
  "elements": null,
  "image_urls": null
}
```



### Output example



```json
{
}
```



## Model code examples

### JavaScript



```javascript
import { sunra } from "@sunra/client";

const result = await sunra.subscribe("kling/kling-o1-standard/reference-to-video", {
  input: {
  	prompt: '',
  	duration: '5',
  	aspect_ratio: '16:9',
  	elements: null,
  	image_urls: null
  },
  logs: true,
  onQueueUpdate: (update) => {
    console.log(`Status Update: ${update.status}, Request ID: ${update.request_id}`);
  },
});
console.log(result.data);
console.log(result.requestId);
```



### Python



```python
import sunra_client

result = sunra_client.subscribe(
    "kling/kling-o1-standard/reference-to-video",
    arguments={
        "prompt": "",
        "duration": "5",
        "aspect_ratio": "16:9",
        "elements": None,
        "image_urls": None
    },
    with_logs=True,
    on_enqueue=print,
    on_queue_update=print,
)
print(result)
```



### Java



```java
import ai.sunra.client.*;
import java.util.Map;
import com.google.gson.JsonObject;

var client = SunraClient.withEnvCredentials();

var response = client.subscribe(
    "kling/kling-o1-standard/reference-to-video",
    SubscribeOptions.<JsonObject>builder()
        .input(Map.of(
            "prompt", "",
            "duration", "5",
            "aspect_ratio", "16:9",
            "elements", null,
            "image_urls", null))
        .resultType(JsonObject.class)
        .onQueueUpdate(update -> System.out.printf(
            "\nStatus Update: %s, Request ID: %s%n",
            update.getStatus(),
            update.getRequestId()
        ))
        .logs(true)
        .build()
);

System.out.println("Completed!");
System.out.println(response.getData());
  
```



### Kotlin



```kotlin
import ai.sunra.client.kt.*
import com.google.gson.JsonObject

val client = createSunraClient()

val response = client.subscribe<JsonObject>(
    endpointId = "kling/kling-o1-standard/reference-to-video",
    input = mapOf(
            "prompt" to "",
            "duration" to "5",
            "aspect_ratio" to "16:9",
            "elements" to null,
            "image_urls" to null),
    options = ai.sunra.client.kt.SubscribeOptions(logs = true),
    onUpdate = { update ->
        println("\nStatus Update: ${update.status}, Request ID: ${update.requestId}")
    }
)

println("Completed!")
println(response.data)
  
```



### Curl



```bash

curl --request POST \
  --url https://api.sunra.ai/v1/queue/kling/kling-o1-standard/reference-to-video \
  --header "Authorization: Key $SUNRA_KEY" \
  --header "Content-Type: application/json" \
  --data '{"prompt":"","duration":"5","aspect_ratio":"16:9","elements":null,"image_urls":null}'
    
```



## Model readme

>