diff --git a/VERSION b/VERSION index 8854156..2157409 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.21.0 +0.22.0 diff --git a/pyproject.toml b/pyproject.toml index c9d17c3..0c1feb0 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "arkruntime" -version = "0.21.0" +version = "0.22.0" description = "Ark runtime SDK for Python" readme = "README.md" requires-python = ">=3.8" diff --git a/src/arkruntime/resources/content_generation/tasks.py b/src/arkruntime/resources/content_generation/tasks.py index ce50163..4eefb38 100644 --- a/src/arkruntime/resources/content_generation/tasks.py +++ b/src/arkruntime/resources/content_generation/tasks.py @@ -20,6 +20,7 @@ from ...types.content_generation.create_content_generation_task_response import CreateContentGenerationTaskResponse from ...types.content_generation.list_content_generation_tasks_response import ListContentGenerationTasksResponse from ...types.content_generation.reasoning_effort import ReasoningEffort +from ...types.content_generation.task_status import TaskStatus from ...types.content_generation.tool_param import ToolParam # AUTOGEN-END create-imports @@ -50,6 +51,13 @@ def create( frames: Optional[int] = None, subdivision_level: Optional[str] = None, file_format: Optional[str] = None, + texture: Optional[bool] = None, + geometry_quality: Optional[str] = None, + geometry_detail: Optional[str] = None, + face: Optional[int] = None, + texture_resolution: Optional[str] = None, + preserve_uv: Optional[bool] = None, + priority: Optional[int] = None, draft: Optional[bool] = None, optimize_prompt: Optional[bool] = None, tools: Optional[List[ToolParam]] = None, @@ -82,6 +90,13 @@ def create( "frames": frames, "subdivision_level": subdivision_level, "file_format": file_format, + "texture": texture, + "geometry_quality": geometry_quality, + "geometry_detail": geometry_detail, + "face": face, + "texture_resolution": texture_resolution, + "preserve_uv": preserve_uv, + "priority": priority, "draft": draft, "optimize_prompt": optimize_prompt, "tools": tools, @@ -125,10 +140,15 @@ def list( # AUTOGEN-START list-kwargs page_num: Optional[int] = None, page_size: Optional[int] = None, - status: Optional[Literal["queued", "running", "cancelled", "succeeded", "failed"]] = None, + status: Optional[Literal["queued", "running", "cancelled", "succeeded", "failed", "expired"]] = None, task_ids: Optional[List[str]] = None, model: Optional[str] = None, service_tier: Optional[str] = None, + endpoint_model: Optional[str] = None, + statuses: Optional[List[TaskStatus]] = None, + limit: Optional[int] = None, + after: Optional[str] = None, + order: Optional[Literal["asc", "desc"]] = None, # AUTOGEN-END list-kwargs extra_headers: Headers | None = None, extra_query: Query | None = None, @@ -151,6 +171,11 @@ def list( "filter.task_ids": task_ids, "filter.model": model, "filter.service_tier": service_tier, + "model": endpoint_model, + "filter.statuses": statuses, + "limit": limit, + "after": after, + "order": order, # AUTOGEN-END list-query }, dict, @@ -201,6 +226,13 @@ async def create( frames: Optional[int] = None, subdivision_level: Optional[str] = None, file_format: Optional[str] = None, + texture: Optional[bool] = None, + geometry_quality: Optional[str] = None, + geometry_detail: Optional[str] = None, + face: Optional[int] = None, + texture_resolution: Optional[str] = None, + preserve_uv: Optional[bool] = None, + priority: Optional[int] = None, draft: Optional[bool] = None, optimize_prompt: Optional[bool] = None, tools: Optional[List[ToolParam]] = None, @@ -233,6 +265,13 @@ async def create( "frames": frames, "subdivision_level": subdivision_level, "file_format": file_format, + "texture": texture, + "geometry_quality": geometry_quality, + "geometry_detail": geometry_detail, + "face": face, + "texture_resolution": texture_resolution, + "preserve_uv": preserve_uv, + "priority": priority, "draft": draft, "optimize_prompt": optimize_prompt, "tools": tools, @@ -276,10 +315,15 @@ async def list( # AUTOGEN-START list-kwargs page_num: Optional[int] = None, page_size: Optional[int] = None, - status: Optional[Literal["queued", "running", "cancelled", "succeeded", "failed"]] = None, + status: Optional[Literal["queued", "running", "cancelled", "succeeded", "failed", "expired"]] = None, task_ids: Optional[List[str]] = None, model: Optional[str] = None, service_tier: Optional[str] = None, + endpoint_model: Optional[str] = None, + statuses: Optional[List[TaskStatus]] = None, + limit: Optional[int] = None, + after: Optional[str] = None, + order: Optional[Literal["asc", "desc"]] = None, # AUTOGEN-END list-kwargs extra_headers: Headers | None = None, extra_query: Query | None = None, @@ -302,6 +346,11 @@ async def list( "filter.task_ids": task_ids, "filter.model": model, "filter.service_tier": service_tier, + "model": endpoint_model, + "filter.statuses": statuses, + "limit": limit, + "after": after, + "order": order, # AUTOGEN-END list-query }, dict, diff --git a/src/arkruntime/types/content_generation/__init__.py b/src/arkruntime/types/content_generation/__init__.py index 023f180..5da46ae 100644 --- a/src/arkruntime/types/content_generation/__init__.py +++ b/src/arkruntime/types/content_generation/__init__.py @@ -14,9 +14,11 @@ from .create_content_generation_task_request import CreateContentGenerationTaskRequest from .create_content_generation_task_response import CreateContentGenerationTaskResponse from .draft_task import DraftTask +from .file_url import FileURL from .image_role import ImageRole from .image_url import ImageURL from .list_content_generation_tasks_response import ListContentGenerationTasksResponse +from .list_order import ListOrder from .reasoning_effort import ReasoningEffort from .task_content import TaskContent from .task_error import TaskError @@ -37,9 +39,11 @@ "CreateContentGenerationTaskRequest", "CreateContentGenerationTaskResponse", "DraftTask", + "FileURL", "ImageRole", "ImageURL", "ListContentGenerationTasksResponse", + "ListOrder", "ReasoningEffort", "TaskContent", "TaskError", @@ -57,6 +61,7 @@ CreateContentGenerationTaskRequestParam, ) from .draft_task_param import DraftTaskParam +from .file_url_param import FileURLParam from .image_url_param import ImageURLParam from .tool_param import ToolParam from .tool_type_param import ToolTypeParam diff --git a/src/arkruntime/types/content_generation/content_generation_task.py b/src/arkruntime/types/content_generation/content_generation_task.py index 450139e..1d317e0 100644 --- a/src/arkruntime/types/content_generation/content_generation_task.py +++ b/src/arkruntime/types/content_generation/content_generation_task.py @@ -91,6 +91,18 @@ class ContentGenerationTask(BaseModel): """ File format echoed back. """ + file_format: Optional[str] = None + """ + Output file format of a 3D generation task. + """ + texture_resolution: Optional[str] = None + """ + Texture resolution actually used by a 3D generation task. + """ + priority: Optional[int] = None + """ + Execution priority echoed back. + """ service_tier: Optional[str] = None """ Service tier the task was scheduled on. diff --git a/src/arkruntime/types/content_generation/content_item.py b/src/arkruntime/types/content_generation/content_item.py index d3130ed..17f864b 100644 --- a/src/arkruntime/types/content_generation/content_item.py +++ b/src/arkruntime/types/content_generation/content_item.py @@ -13,6 +13,7 @@ from .audio_url import AudioURL from .content_type import ContentType from .draft_task import DraftTask +from .file_url import FileURL from .image_url import ImageURL from .video_url import VideoURL @@ -20,7 +21,8 @@ class ContentItem(BaseModel): """ One element of a generation request `content` list. Exactly one of - `text` / `image_url` / `video_url` / `audio_url` / `draft_task` must be + `text` / `image_url` / `video_url` / `audio_url` / `draft_task` / + `file_url` must be set, matching the value of `type`. """ @@ -48,7 +50,14 @@ class ContentItem(BaseModel): """ Draft-task reference. Required when `type` is `draft_task`. """ + file_url: Optional[FileURL] = None + """ + File content. Required when `type` is `file_url`. + """ role: Optional[str] = None """ - Optional role tag (e.g. `first_frame`, `reference_image`). + Optional role tag (e.g. `first_frame`, `reference_image`). 3D generation + uses `front_view` / `back_view` / `left_view` / `right_view` / + `top_view` / `bottom_view` for images and `mesh_to_texture` for the mesh + file. """ diff --git a/src/arkruntime/types/content_generation/content_item_param.py b/src/arkruntime/types/content_generation/content_item_param.py index d95743e..2e87a69 100644 --- a/src/arkruntime/types/content_generation/content_item_param.py +++ b/src/arkruntime/types/content_generation/content_item_param.py @@ -13,6 +13,7 @@ from .audio_url_param import AudioURLParam from .content_type import ContentType from .draft_task_param import DraftTaskParam +from .file_url_param import FileURLParam from .image_url_param import ImageURLParam from .video_url_param import VideoURLParam @@ -20,7 +21,8 @@ class ContentItemParam(TypedDict, total=False): """ One element of a generation request `content` list. Exactly one of - `text` / `image_url` / `video_url` / `audio_url` / `draft_task` must be + `text` / `image_url` / `video_url` / `audio_url` / `draft_task` / + `file_url` must be set, matching the value of `type`. """ @@ -42,5 +44,13 @@ class ContentItemParam(TypedDict, total=False): draft_task: Optional[DraftTaskParam] """Draft-task reference. Required when `type` is `draft_task`.""" + file_url: Optional[FileURLParam] + """File content. Required when `type` is `file_url`.""" + role: Optional[str] - """Optional role tag (e.g. `first_frame`, `reference_image`).""" + """ + Optional role tag (e.g. `first_frame`, `reference_image`). 3D generation + uses `front_view` / `back_view` / `left_view` / `right_view` / + `top_view` / `bottom_view` for images and `mesh_to_texture` for the mesh + file. + """ diff --git a/src/arkruntime/types/content_generation/content_type.py b/src/arkruntime/types/content_generation/content_type.py index fc8e855..411a92f 100644 --- a/src/arkruntime/types/content_generation/content_type.py +++ b/src/arkruntime/types/content_generation/content_type.py @@ -19,3 +19,4 @@ class ContentType(str, Enum): video_url = "video_url" audio_url = "audio_url" draft_task = "draft_task" + file_url = "file_url" diff --git a/src/arkruntime/types/content_generation/create_content_generation_task_request.py b/src/arkruntime/types/content_generation/create_content_generation_task_request.py index 40ba740..144f0e2 100644 --- a/src/arkruntime/types/content_generation/create_content_generation_task_request.py +++ b/src/arkruntime/types/content_generation/create_content_generation_task_request.py @@ -80,6 +80,36 @@ class CreateContentGenerationTaskRequest(BaseModel): """ Output file format (e.g. `mp4`, `glb`). """ + texture: Optional[bool] = None + """ + 3D generation with image-only input: `false` generates an untextured + mesh, omitted or `true` generates a textured model. + """ + geometry_quality: Optional[str] = None + """ + 3D geometry quality tier: `low`, `medium`, `high`, `xhigh` or `ultra`. + """ + geometry_detail: Optional[str] = None + """ + 3D surface detail: `smooth` or `micro`. Only valid when + `geometry_quality` is `high`, `xhigh` or `ultra`. + """ + face: Optional[int] = None + """ + Target face count of the 3D mesh, within the range of `geometry_quality`. + """ + texture_resolution: Optional[str] = None + """ + 3D texture resolution: `4k` or `8k`. + """ + preserve_uv: Optional[bool] = None + """ + Keep the UV layout of the input mesh when texturing it. + """ + priority: Optional[int] = None + """ + Execution priority within the endpoint queue, 0-9; higher runs first. + """ draft: Optional[bool] = None """ Mark this task as a draft (cheaper, lower-quality). diff --git a/src/arkruntime/types/content_generation/create_content_generation_task_request_param.py b/src/arkruntime/types/content_generation/create_content_generation_task_request_param.py index d38dd0f..50b5928 100644 --- a/src/arkruntime/types/content_generation/create_content_generation_task_request_param.py +++ b/src/arkruntime/types/content_generation/create_content_generation_task_request_param.py @@ -64,6 +64,33 @@ class CreateContentGenerationTaskRequestParam(TypedDict, total=False): file_format: Optional[str] """Output file format (e.g. `mp4`, `glb`).""" + texture: Optional[bool] + """ + 3D generation with image-only input: `false` generates an untextured + mesh, omitted or `true` generates a textured model. + """ + + geometry_quality: Optional[str] + """3D geometry quality tier: `low`, `medium`, `high`, `xhigh` or `ultra`.""" + + geometry_detail: Optional[str] + """ + 3D surface detail: `smooth` or `micro`. Only valid when + `geometry_quality` is `high`, `xhigh` or `ultra`. + """ + + face: Optional[int] + """Target face count of the 3D mesh, within the range of `geometry_quality`.""" + + texture_resolution: Optional[str] + """3D texture resolution: `4k` or `8k`.""" + + preserve_uv: Optional[bool] + """Keep the UV layout of the input mesh when texturing it.""" + + priority: Optional[int] + """Execution priority within the endpoint queue, 0-9; higher runs first.""" + draft: Optional[bool] """Mark this task as a draft (cheaper, lower-quality).""" diff --git a/src/arkruntime/types/content_generation/file_url.py b/src/arkruntime/types/content_generation/file_url.py new file mode 100644 index 0000000..4f48dd1 --- /dev/null +++ b/src/arkruntime/types/content_generation/file_url.py @@ -0,0 +1,16 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` in ark-apis. +# +# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +# SPDX-License-Identifier: Apache-2.0 + +from __future__ import annotations + +from arkruntime._models import BaseModel + + +class FileURL(BaseModel): + url: str + """ + URL of the file asset (e.g. a GLB mesh for 3D generation). + """ diff --git a/src/arkruntime/types/content_generation/file_url_param.py b/src/arkruntime/types/content_generation/file_url_param.py new file mode 100644 index 0000000..973ead2 --- /dev/null +++ b/src/arkruntime/types/content_generation/file_url_param.py @@ -0,0 +1,14 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` in ark-apis. +# +# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +# SPDX-License-Identifier: Apache-2.0 + +from __future__ import annotations + +from typing_extensions import Required, TypedDict + + +class FileURLParam(TypedDict, total=False): + url: Required[str] + """URL of the file asset (e.g. a GLB mesh for 3D generation).""" diff --git a/src/arkruntime/types/content_generation/list_content_generation_tasks_response.py b/src/arkruntime/types/content_generation/list_content_generation_tasks_response.py index 2431d24..ab365b3 100644 --- a/src/arkruntime/types/content_generation/list_content_generation_tasks_response.py +++ b/src/arkruntime/types/content_generation/list_content_generation_tasks_response.py @@ -6,7 +6,7 @@ from __future__ import annotations -from typing import List +from typing import List, Optional from arkruntime._models import BaseModel @@ -14,11 +14,27 @@ class ListContentGenerationTasksResponse(BaseModel): - total: int + total: Optional[int] = None """ - Total number of tasks matching the filter (across all pages). + Total number of tasks matching the filter (across all pages). Not returned by List V2. """ - items: List[ContentGenerationTask] + items: Optional[List[ContentGenerationTask]] = None """ - Page of tasks. + Page of tasks. Not returned by List V2. + """ + data: Optional[List[ContentGenerationTask]] = None + """ + List V2: page of tasks. + """ + first_id: Optional[str] = None + """ + List V2: id of the first task in `data`; null when `data` is empty. + """ + last_id: Optional[str] = None + """ + List V2: id of the last task in `data`; null when `data` is empty. + """ + has_more: Optional[bool] = None + """ + List V2: whether more tasks follow this page. """ diff --git a/src/arkruntime/types/content_generation/list_order.py b/src/arkruntime/types/content_generation/list_order.py new file mode 100644 index 0000000..2e17aa1 --- /dev/null +++ b/src/arkruntime/types/content_generation/list_order.py @@ -0,0 +1,18 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` in ark-apis. +# +# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +# SPDX-License-Identifier: Apache-2.0 + +from __future__ import annotations + +from enum import Enum + + +class ListOrder(str, Enum): + """ + Sort order of a task list page, by creation time. + """ + + asc = "asc" + desc = "desc" diff --git a/src/arkruntime/types/content_generation/task_status.py b/src/arkruntime/types/content_generation/task_status.py index 3ff02f7..4bebf44 100644 --- a/src/arkruntime/types/content_generation/task_status.py +++ b/src/arkruntime/types/content_generation/task_status.py @@ -19,3 +19,4 @@ class TaskStatus(str, Enum): cancelled = "cancelled" succeeded = "succeeded" failed = "failed" + expired = "expired" diff --git a/uv.lock b/uv.lock index f0b818e..5fc1715 100644 --- a/uv.lock +++ b/uv.lock @@ -79,7 +79,7 @@ wheels = [ [[package]] name = "arkruntime" -version = "0.21.0" +version = "0.22.0" source = { editable = "." } dependencies = [ { name = "anyio", version = "4.5.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },