> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cargar medios

> Carga un archivo multimedia para usarlo en Publicaciones u otros contenidos.



## OpenAPI

````yaml /es/openapi.json POST /2/media/upload
openapi: 3.0.0
info:
  description: Endpoints disponibles en X API v2
  version: '2.157'
  title: X API v2
  termsOfService: https://developer.x.com/en/developer-terms/agreement-and-policy.html
  contact:
    name: X Developers
    url: https://developer.x.com/
  license:
    name: X Developer Agreement and Policy
    url: https://developer.x.com/en/developer-terms/agreement-and-policy.html
servers:
  - description: X API
    url: https://api.x.com
security: []
tags:
  - name: Account Activity
    description: Endpoints para recuperar y administrar suscripciones AAA
    externalDocs:
      description: Más información
      url: >-
        https://docs.x.com/x-api/enterprise-gnip-2.0/fundamentals/account-activity
  - name: Bookmarks
    description: >-
      Endpoints relacionados con la recuperación y gestión de los marcadores de
      un usuario
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/bookmarks
  - name: Compliance
    description: >-
      Endpoints relacionados con garantizar que los datos de X en tus sistemas
      cumplan la normativa
    externalDocs:
      description: Más información
      url: >-
        https://developer.twitter.com/en/docs/twitter-api/compliance/batch-tweet/introduction
  - name: Connections
    description: Endpoints relacionados con conexiones de streaming
    externalDocs:
      description: Más información
      url: https://developer.x.com/en/docs/x-api/connections
  - name: Direct Messages
    description: Endpoints relacionados con la recuperación y gestión de Mensajes Directos
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/direct-messages
  - name: General
    description: Endpoints diversos para la funcionalidad general de la API
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api
  - name: Lists
    description: Endpoints relacionados con la obtención y gestión de Listas
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/lists
  - name: Media
    description: Endpoints relacionados con Media
    externalDocs:
      description: Más información
      url: https://developer.x.com
  - name: MediaUpload
    description: Endpoints relacionados con la carga de Media
    externalDocs:
      description: Más información
      url: https://developer.x.com
  - name: News
    description: Endpoint para obtener noticias
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/news
  - name: Spaces
    description: Endpoints relacionados con la obtención y gestión de Spaces
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/spaces
  - name: Stream
    description: Endpoints relacionados con la transmisión en tiempo real
    externalDocs:
      description: Más información
      url: https://developer.x.com
  - name: Tweets
    description: Endpoints relacionados con la obtención, búsqueda y modificación de Tweets
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/tweets/lookup
  - name: Users
    description: >-
      Endpoints relacionados con la obtención y gestión de relaciones entre
      usuarios
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/users/lookup
paths:
  /2/media/upload:
    post:
      tags:
        - Media
      summary: Cargar medios
      description: >-
        Carga un archivo multimedia para usarlo en Publicaciones u otros
        contenidos.
      operationId: mediaUpload
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MediaUploadRequestOneShot'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/MediaUploadRequestOneShot'
      responses:
        '200':
          description: La solicitud se ha completado correctamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaUploadResponse'
        default:
          description: La solicitud ha fallado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
        - OAuth2UserToken:
            - media.write
        - UserToken: []
      externalDocs:
        url: https://docs.x.com/x-api/media/media-upload
components:
  schemas:
    MediaUploadRequestOneShot:
      type: object
      required:
        - media
        - media_category
      properties:
        additional_owners:
          type: array
          items:
            $ref: '#/components/schemas/UserId'
        media:
          anyOf:
            - $ref: '#/components/schemas/MediaPayloadBinary'
            - $ref: '#/components/schemas/MediaPayloadByte'
        media_category:
          $ref: '#/components/schemas/MediaCategoryOneShot'
        media_type:
          type: string
          description: El tipo de imagen o subtítulo.
          enum:
            - text/srt
            - text/vtt
            - image/jpeg
            - image/bmp
            - image/png
            - image/webp
            - image/pjpeg
            - image/tiff
          example: image/png
        shared:
          type: boolean
          description: Indica si este contenido multimedia se comparte o no.
          default: false
      additionalProperties: false
    MediaUploadResponse:
      type: object
      description: >-
        Una respuesta al consultar el estado de una solicitud de carga de
        contenido multimedia.
      required:
        - meta
      properties:
        data:
          type: object
          required:
            - id
            - media_key
          properties:
            expires_after_secs:
              type: integer
              description: Número de segundos tras los cuales caduca la sesión de carga.
              format: int32
            id:
              $ref: '#/components/schemas/MediaId'
            media_key:
              $ref: '#/components/schemas/MediaKey'
            processing_info:
              $ref: '#/components/schemas/ProcessingInfo'
            size:
              type: integer
              description: Tamaño de la carga.
              format: int32
        errors:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/Problem'
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
    Problem:
      type: object
      description: >-
        Un objeto HTTP Problem Details, tal como se define en el IETF RFC 7807
        (https://tools.ietf.org/html/rfc7807).
      required:
        - type
        - title
      properties:
        detail:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          type: string
      discriminator:
        propertyName: type
        mapping:
          about:blank:
            $ref: '#/components/schemas/GenericProblem'
          https://api.twitter.com/2/problems/client-disconnected:
            $ref: '#/components/schemas/ClientDisconnectedProblem'
          https://api.twitter.com/2/problems/client-forbidden:
            $ref: '#/components/schemas/ClientForbiddenProblem'
          https://api.twitter.com/2/problems/conflict:
            $ref: '#/components/schemas/ConflictProblem'
          https://api.twitter.com/2/problems/disallowed-resource:
            $ref: '#/components/schemas/DisallowedResourceProblem'
          https://api.twitter.com/2/problems/duplicate-rules:
            $ref: '#/components/schemas/DuplicateRuleProblem'
          https://api.twitter.com/2/problems/invalid-request:
            $ref: '#/components/schemas/InvalidRequestProblem'
          https://api.twitter.com/2/problems/invalid-rules:
            $ref: '#/components/schemas/InvalidRuleProblem'
          https://api.twitter.com/2/problems/noncompliant-rules:
            $ref: '#/components/schemas/NonCompliantRulesProblem'
          https://api.twitter.com/2/problems/not-authorized-for-field:
            $ref: '#/components/schemas/FieldUnauthorizedProblem'
          https://api.twitter.com/2/problems/not-authorized-for-resource:
            $ref: '#/components/schemas/ResourceUnauthorizedProblem'
          https://api.twitter.com/2/problems/operational-disconnect:
            $ref: '#/components/schemas/OperationalDisconnectProblem'
          https://api.twitter.com/2/problems/resource-not-found:
            $ref: '#/components/schemas/ResourceNotFoundProblem'
          https://api.twitter.com/2/problems/resource-unavailable:
            $ref: '#/components/schemas/ResourceUnavailableProblem'
          https://api.twitter.com/2/problems/rule-cap:
            $ref: '#/components/schemas/RulesCapProblem'
          https://api.twitter.com/2/problems/streaming-connection:
            $ref: '#/components/schemas/ConnectionExceptionProblem'
          https://api.twitter.com/2/problems/unsupported-authentication:
            $ref: '#/components/schemas/UnsupportedAuthenticationProblem'
          https://api.twitter.com/2/problems/usage-capped:
            $ref: '#/components/schemas/UsageCapExceededProblem'
    UserId:
      type: string
      description: >-
        Identificador único de este usuario. Se devuelve como una cadena para
        evitar complicaciones con lenguajes de programación y herramientas que
        no pueden manejar números enteros grandes.
      pattern: ^[0-9]{1,19}$
      example: '2244994945'
    MediaPayloadBinary:
      type: string
      description: El archivo que se va a subir.
      format: binary
    MediaPayloadByte:
      type: string
      description: El archivo que se va a subir.
      format: byte
    MediaCategoryOneShot:
      type: string
      description: >-
        Un valor de enumeración de tipo cadena (string) que identifica un caso
        de uso de contenido multimedia. Este identificador se utiliza para
        aplicar restricciones específicas del caso de uso (por ejemplo, tamaño
        de archivo) y habilitar funciones avanzadas.
      enum:
        - tweet_image
        - dm_image
        - subtitles
      example: tweet_image
    MediaId:
      type: string
      description: El identificador único de este contenido multimedia.
      pattern: ^[0-9]{1,19}$
      example: '1146654567674912769'
    MediaKey:
      type: string
      description: El identificador Media Key para este archivo adjunto.
      pattern: ^([0-9]+)_([0-9]+)$
    ProcessingInfo:
      type: object
      required:
        - type
      properties:
        check_after_secs:
          type: integer
          description: Número de segundos antes de volver a comprobar el estado.
          format: int32
        progress_percent:
          type: integer
          description: Porcentaje de progreso de la carga.
          format: int32
        state:
          type: string
          description: Estado de la carga.
          enum:
            - succeeded
            - in_progress
            - pending
            - failed
    GenericProblem:
      description: >-
        Un problema genérico sin información adicional aparte de la
        proporcionada por el código de estado HTTP.
      allOf:
        - $ref: '#/components/schemas/Problem'
    ClientDisconnectedProblem:
      description: Tu cliente se ha desconectado.
      allOf:
        - $ref: '#/components/schemas/Problem'
    ClientForbiddenProblem:
      description: >-
        Un Problem que indica que tu cliente no tiene permiso para realizar esta
        solicitud.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            reason:
              type: string
              enum:
                - official-client-forbidden
                - client-not-enrolled
            registration_url:
              type: string
              format: uri
    ConflictProblem:
      description: No puedes crear un nuevo trabajo si ya hay uno en ejecución.
      allOf:
        - $ref: '#/components/schemas/Problem'
    DisallowedResourceProblem:
      description: >-
        Un Problem que indica que el recurso solicitado infringe las normas de
        esta API.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - resource_id
            - resource_type
            - section
          properties:
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            section:
              type: string
              enum:
                - data
                - includes
    DuplicateRuleProblem:
      description: La regla enviada es un duplicado.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            id:
              type: string
            value:
              type: string
    InvalidRequestProblem:
      description: Un problema que indica que esta solicitud no es válida.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            errors:
              type: array
              minItems: 1
              items:
                type: object
                properties:
                  message:
                    type: string
                  parameters:
                    type: object
                    additionalProperties:
                      type: array
                      items:
                        type: string
    InvalidRuleProblem:
      description: La regla que has enviado no es válida.
      allOf:
        - $ref: '#/components/schemas/Problem'
    NonCompliantRulesProblem:
      description: >-
        Un Problem que indica que el conjunto de reglas del usuario no cumple
        las normas.
      allOf:
        - $ref: '#/components/schemas/Problem'
    FieldUnauthorizedProblem:
      description: >-
        Un Problem que indica que no tienes permiso para ver un campo específico
        de un Tweet, un usuario, etc.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - resource_type
            - field
            - section
          properties:
            field:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            section:
              type: string
              enum:
                - data
                - includes
    ResourceUnauthorizedProblem:
      description: >-
        Un problema que indica que no tienes permiso para ver un Tweet, un
        usuario, etc. específicos.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - value
            - resource_id
            - resource_type
            - section
            - parameter
          properties:
            parameter:
              type: string
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            section:
              type: string
              enum:
                - data
                - includes
            value:
              type: string
    OperationalDisconnectProblem:
      description: Se te ha desconectado por motivos operativos.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            disconnect_type:
              type: string
              enum:
                - OperationalDisconnect
                - UpstreamOperationalDisconnect
                - ForceDisconnect
                - UpstreamUncleanDisconnect
                - SlowReader
                - InternalError
                - ClientApplicationStateDegraded
                - InvalidRules
    ResourceNotFoundProblem:
      description: Un objeto Problem que indica que un Tweet, un usuario, etc., no existe.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - parameter
            - value
            - resource_id
            - resource_type
          properties:
            parameter:
              type: string
              minLength: 1
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            value:
              type: string
              description: El valor coincidirá con el esquema definido para el campo.
    ResourceUnavailableProblem:
      description: >-
        Un problema que indica que un Tweet, un usuario, etc. específicos no
        están disponibles para ti.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - parameter
            - resource_id
            - resource_type
          properties:
            parameter:
              type: string
              minLength: 1
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
    RulesCapProblem:
      description: Has excedido el número máximo de reglas permitido.
      allOf:
        - $ref: '#/components/schemas/Problem'
    ConnectionExceptionProblem:
      description: Un Problem que indica que algo va mal con la conexión.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            connection_issue:
              type: string
              enum:
                - TooManyConnections
                - ProvisioningSubscription
                - RuleConfigurationIssue
                - RulesInvalidIssue
    UnsupportedAuthenticationProblem:
      description: Un Problem que indica que la autenticación utilizada no es compatible.
      allOf:
        - $ref: '#/components/schemas/Problem'
    UsageCapExceededProblem:
      description: Un problema que indica que se ha superado un límite de uso.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            period:
              type: string
              enum:
                - Daily
                - Monthly
            scope:
              type: string
              enum:
                - Account
                - Product
  securitySchemes:
    OAuth2UserToken:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://api.x.com/2/oauth2/authorize
          tokenUrl: https://api.x.com/2/oauth2/token
          scopes:
            block.read: View accounts you have blocked.
            bookmark.read: Read your bookmarked Posts.
            bookmark.write: Create and delete your bookmarks.
            dm.read: Read all your Direct Messages.
            dm.write: Send and manage your Direct Messages.
            follows.read: View accounts you follow and accounts following you.
            follows.write: Follow and unfollow accounts on your behalf.
            like.read: View Posts you have liked and likes you can see.
            like.write: Like and unlike Posts on your behalf.
            list.read: >-
              View Lists, members, and followers of Lists you created or are a
              member of, including private Lists.
            list.write: Create and manage Lists on your behalf.
            media.write: Upload media, such as photos and videos, on your behalf.
            mute.read: View accounts you have muted.
            mute.write: Mute and unmute accounts on your behalf.
            offline.access: Request a refresh token for the app.
            space.read: View all Spaces you have access to.
            timeline.read: >-
              View all Custom Timelines you can see, including public Custom
              Timelines from other developers.
            tweet.moderate.write: Hide and unhide replies to your Posts.
            tweet.read: >-
              View all Posts you can see, including those from protected
              accounts.
            tweet.write: Post and repost on your behalf.
            users.read: View any account you can see, including protected accounts.
    UserToken:
      type: http
      scheme: OAuth

````